With directory synchronization you can continue to manage users and groups on-premises and synchronize additions, deletions, and changes to the cloud. But setup is a little complicated and it can sometimes be difficult to identify the source of problems. No worries! We have resources to help you hunt down potential issues and fix them.

Common causes of problems with directory synchronization

  • Duplicate or invalid attributes. You may need to correct some attribute values in your on-premises directory. Common problems that need to be corrected are duplicate SMTP addresses, duplicate UPNs, or empty display names.
  • Object quota exceeded. We have a built-in object quota to help protect the service. If you have too many objects in your directory that need to sync to Office 365, you’ll have to contact Support to increase your quota.

Troubleshoot and resolve issues

I’m having problems installing the directory synchronization tool

Take a look at How to troubleshoot Windows Azure Active Directory Sync Tool installation and Configuration Wizard error messages in Office 365 for information about the system requirements to install Windows Azure Active Directory Sync Tool, the permissions you need, and how to troubleshoot common errors.

I received a directory synchronization error report

You may have to clean up your local Active Directory Domain Services to fix any attributes that are causing sync issues. Here’s some options to get started on a solution:

I need to know which attributes are synced

You can find a list of all the attributes that are synced between on-premises and the cloud right here.

I can’t manage or remove objects that were synced to the cloud

Are you ready to manage objects in the cloud only? Or is there an object that was deleted on-premises, but is stuck in the cloud? Take a look at this support article for guidance on how to resolve these issues.

I got an error message that my company has exceeded the number of objects that
can be synchronized

You can read more about the issue here. Run OnRamp automatic checks to verify the count of your local Active Directory objects. Select directory synchronization as your user management option, and we’ll see if this is a blocking issue for you. If it is, you can contact Support to request a quota increase.

Other resources

Diagnostic tools

  • OnRamp: Answer a few questions about how you want to set up your organization, and OnRamp runs automatic checks against your environment to verify the readiness of your on-premises organization. View the results in the users & groups category to identify possible issues with directory synchronization.