How Microsoft Entra Connect works in Microsoft 365

Original KB number:   4052070

Summary

Microsoft Entra Connect is used to synchronize data to Microsoft Entra ID. Microsoft Entra Connect checks and validates information along the way. Sync errors may occur, and new objects or updated values may not reach Microsoft Entra ID.

It's important to understand the flow of data from on-premises to the cloud in Exchange Online. If a failure or error occurs, this article can help determine where the problem is occurring and how to fix it.

High-level workflow

Screenshot of the High-Level workflow from source on-premises AD to a source connector space.

  1. The data flows from source on-premises AD to a source connector space.

    During this process, new objects and changes to existing objects are evaluated and if any conflicts exist, they're flagged. If the object is new and errors are present, the object isn't provisioned.

    If it's an existing object, the conflicting data may not be passed forward. The object may continue to function. However, the desired change, intended or accidental, isn't made. It triggers a DirSync error that has to be corrected in source AD.

    For more information, see the following articles:

  2. If a change passes the first stage, it enters the Metaverse, and then the change is passed along to the Target Connector Space. For more information, see Sync Service Manager Metaverse Search.

  3. If there are no issues, the change is populated into the Target Data Store and Microsoft Entra ID. At this point, you can use the Get-MSOLUser command and other Azure commands against the object to view them in Microsoft Entra ID.

    If a problem occurs between the Target Connector Space and Microsoft Entra ID, you may have to remove the object from Microsoft Entra ID by using the Remove-MsolUser cmdlet. You can't force Microsoft Entra ID to reevaluate the object as you can in MMSSPP.

    Note

    Azure AD and MSOnline PowerShell modules are deprecated as of March 30, 2024. To learn more, read the deprecation update. After this date, support for these modules are limited to migration assistance to Microsoft Graph PowerShell SDK and security fixes. The deprecated modules will continue to function through March, 30 2025.

    We recommend migrating to Microsoft Graph PowerShell to interact with Microsoft Entra ID (formerly Azure AD). For common migration questions, refer to the Migration FAQ. Note: Versions 1.0.x of MSOnline may experience disruption after June 30, 2024.

  4. Finally, the data synchronizes to Exchange, where the object exists as a Mailbox, MailUser, Resource, and so on. It's known as Forward Sync. If there's a problem on an object between Microsoft Entra ID and Exchange Online (represented by validation errors), ask Microsoft to submit the object for a Forward Sync from Microsoft Entra ID to Exchange Online to force this action.

More information

For more information about this topic, see the following article and explore the topics in the left navigation pane:

What is hybrid identity with Microsoft Entra ID?

A related topic is Active Directory Federation Services. See the following articles for more information.

Here are articles for some common issues: