The AD Object Merging Wizard associates Contacts with AD objects by comparing the unique values of a particular AD object attribute to the unique values of a corresponding column in the SQL Server database. Where these values match, the associated Contact and AD Object are assumed to represent the same entity, and the two are therefore merged. During the Wizard's run, the Choose Your Method... screen requires that you specify the AD attribute and the database column to use for these comparisons. The designations on that screen are accomplished by drop-down list boxes that list available options for the database column and AD attribute, respectively.
By default, the list of choices for the AD attribute contains these 26 options:
cn
mail
mailNickname
proxyAddresses
sAMAcountName
userPrincipalName
targetAddress
employeeNumber
distinguishedName
altRecipient
legacyExchangeDN
extensionAttribute1
extensionAttribute2
extensionAttribute3
extensionAttribute4
extensionAttribute5
extensionAttribute6
extensionAttribute7
extensionAttribute8
extensionAttribute9
extensionAttribute10
extensionAttribute11
extensionAttribute12
extensionAttribute13
extensionAttribute14
extensionAttribute15
The 26 defaults are defined by a series of ADML[#] parameters in the [ActiveDirectoryMatchList] section of the Global Defaults and Task Parameters:
[ActiveDirectoryMatchList]
Count=26
ADML0=cn
ADML1=mail
ADML2=mailNickname
ADML3=proxyAddresses
ADML4=sAMAccountName
[...]
ADML25=extensionAttribute15
If the AD attribute you want to use is not among the 26 defaults, you can add one or more other attributes to the list by defining each addition in the Global Defaults or Task Parameters. See How Do I Add or Edit Program Parameters? from the Quest Notes Migrator for Exchange 4.1 User Guide for more information for the procedure to add and edit these parameter(s):
- ADML[#]=<AttribName>
Each ADML[#] parameter names an AD attribute that the AD Object Merging Wizard will include in its list of options, from which one attribute must be chosen to facilitate the matching of Contacts with AD objects. The digit(s) appended to an ADML[#] key name differentiate one parameter from another. The multiple ADML[#] parameters need not appear in numerical order, and need not form an uninterrupted numerical sequence. But the Wizard will read only ADML[#] parameters whose differentiating digits are less than a value specified by a Count= parameter (see below).
Note: Any AD attribute to be added to the list must be replicated to the Global Catalog, or the merge function will fail. You can configure AD to replicate an attribute to the Global Catalog, as explained in How Do I Configure AD To Replicate an AD Attribute to the Global Catalog? from the Quest Notes Migrator for Exchange 4.1 User Guide.
Count=<##>
A limit to the number of ADML[#] parameters (see above) that the AD Object Merging Wizard will process in this section. The Wizard will read only ADML[#] parameters whose differentiating digits are less than the Count= parameter value. For example, if:
[ActiveDirectoryMatchList]
Count=6
ADML0=cn
ADML1=mail
ADML2=mailNickname
ADML3=proxyAddresses
ADML4=sAMAccountName
ADML5=userPrincipalName
ADML6=targetAddress
ADML7=employeeNumber
... then the Wizard will read all of the parameters except ADML6 and ADML7, since Count=6, and neither 6 nor 7 is less than 6.
If unspecified, the Count= parameter defaults to 26. If specified, the parameter must occur as the first line of the section, as shown above.
For example: If the ADML[#] parameters are set for only their 26 defaults, and you want to add a single new AD attribute option, you would add an ADML26= parameter and change the Count= parameter to 27, like this:
[ActiveDirectoryMatchList]
Count=27
ADML0=cn
ADML1=mail
ADML2=mailNickname
ADML3=proxyAddresses
ADML4=sAMAccountName
[...]
ADML25=extensionAttribute15
ADML26=NewAttributeName
