Can I modify the DN format of objects created in Active Directory (AD)?

Created: 2012-04-20 08:09:59
Modified: 2020-08-10 12:57:04
Tags: Active Directory AD LDS ADAM Custom Mapping Exchange 20xx Features UnitySync

The default DN mapping for creation of a destination AD contact is:

This results is a DN that looks something like this:,ou=SyncContainer,dc=domain,dc=com

IMPORTANT NOTE: When viewing an object created by UnitySync with this default mapping in AD Users and Computers (U&C), the Name column matches the CN value in the DN. This Name value should not be confused with the displayname attribute which is seen in the Global Address List (GAL). If you want to see displayname in AD U&C, select the Displayname column to be viewed.

This default value for CN is preferred because the mail value is far more likely to be unique than displayname (or any name part combination). If you have duplicate name values (i.e. John Smith), subsequent objects with the same name won’t sync, and instead will throw a Duplicate DN error instead. Therefore, using the default DN mapping is strongly recommended.

Having said that, if you really must, UnitySync is highly configurable and you do have the ability to customize the DN mapping to use a different attribute even though it is not recommended.

Create a custom OBJECT mapfile and modify the first line, which is the DN mapping. For example: dn=cn=~cn#64~,~struct~

In this example, the value of ~cn~ is the displayname value in the format selected on the Display Name tab of the UnitySync User Interface (UI). Any value surrounded by tilde’s refers to a value generated at sync time. If you have a different need for a custom DN mapping, or further questions about this or any other custom mapping, please forward your custom map file as well as your latest high level Sync or Sim logs (3-Detailed preferred) to

Custom map files are located in \C:\UnitySync-v2.x\Global\Map\Custom. Logs are located in \UnitySync-v2.x\Connections\YourConnectionName\Log.

Share this article:

  1. Directify - Self Service

  2. Mimic - Replication

  3. UnitySync - Sync
  1. emPass - Sync
  1. Profiler
  2. SimpleSync