Migrate to Microsoft Entra Cloud Sync
In brief
The guide now describes phased migration planning, including Cloud Sync device synchronization for Microsoft Entra hybrid join and prerequisite checks.
What Entra admins need to know
Administrators planning a migration should include device synchronization in their plan when applicable and review the listed prerequisites.
This editorial summary was generated by AI from the documentation changes. Verify important details in the full Microsoft Learn article.
Documentation change
The comparison below shows only the changed extract. Use the full-page view for complete context.
Migrating from Microsoft Entra Connect to Microsoft Entra Cloud Sync
Microsoft Entra Cloud Sync is the future for accomplishing your hybrid identity goals for synchronization ofsynchronizes users, groups, and contacts from Active Directory to Microsoft Entra ID. It usesID by using the Microsoft Entra cloud provisioning agent instead of theagent. When device sync is enabled, Cloud Sync can also synchronize computer objects for Microsoft Entra hybrid join. Use this guide to plan a phased migration from Microsoft Entra Connect application. If you're currently using Microsoft Entra Connect and wish to move to cloud sync, the following document provides guidance.Cloud Sync.
Steps for migrating from Microsoft Entra Connect to cloud syncCloud Sync
| Step | Description |
|---|---|
| Choose the best sync tool | Before moving to cloud sync, you should verify that cloud sync is currently the best synchronization tool for you. You can do this task by reviewing the supported sync scenarios comparison. |
| Verify the |
|
| Back up your Microsoft Entra Connect configuration | Before making any changes, you should back up your Microsoft Entra Connect configuration. This way, you can rollback. For more information, see Import and export Microsoft Entra Connect configuration settings. |
| Review the migration tutorial | To become familiar with the migration process, review the Migrate to Microsoft Entra Cloud Sync for an existing synced AD forest tutorial. This tutorial guides you through the migration process in a sandbox environment. |
| Create or identify an OU for the migration | Create a new OU or identify an existing OU that contains the users you'll test migration on. Keep this OU in Microsoft Entra Connect Sync scope during migration. |
@@ -1,21 +1,23 @@ ----title: 'Migrate Microsoft Entra Connect to Microsoft Entra Cloud Sync| Microsoft Docs'-description: Describes steps to migrate Microsoft Entra Connect to Microsoft Entra Cloud Sync.+title: Migrate to Microsoft Entra Cloud Sync+description: Learn how to plan a phased migration from Microsoft Entra Connect to Microsoft Entra Cloud Sync, including device synchronization and prerequisite checks. -ms.custom: no-azure-ad-ps-ref+ms.custom: no-azure-ad-ps-ref, msecd-doc-authoring-1023 ms.topic: how-to-ms.date: 04/09/2025+ms.date: 10/06/2026 ms.subservice: hybrid-cloud-sync+ai-usage: ai-assisted+#customer intent: As an IT administrator using Microsoft Entra Connect, I want to plan a phased migration to Microsoft Entra Cloud Sync so that I can move synchronization without disrupting users. --- # Migrating from Microsoft Entra Connect to Microsoft Entra Cloud Sync -Microsoft Entra Cloud Sync is the future for accomplishing your hybrid identity goals for synchronization of users, groups, and contacts to Microsoft Entra ID. It uses the Microsoft Entra cloud provisioning agent instead of the Microsoft Entra Connect application. If you're currently using Microsoft Entra Connect and wish to move to cloud sync, the following document provides guidance.+Microsoft Entra Cloud Sync synchronizes users, groups, and contacts from Active Directory to Microsoft Entra ID by using the Microsoft Entra provisioning agent. When device sync is enabled, Cloud Sync can also synchronize computer objects for Microsoft Entra hybrid join. Use this guide to plan a phased migration from Microsoft Entra Connect to Cloud Sync. <a name='steps-for-migrating-from-azure-ad-connect-to-cloud-sync'></a> -## Steps for migrating from Microsoft Entra Connect to cloud sync+## Steps for migrating from Microsoft Entra Connect to Cloud Sync > [!IMPORTANT] > During the pilot or coexistence phase, don't remove OUs, domains, groups, users, contacts, or other referenced objects from Microsoft Entra Connect Sync scope. Keep the existing scope configured until objects are fully migrated and you're ready for final cutover. Removing objects from scope before final cutover is unsafe: it can drop references in the Microsoft Entra connector space and export reference deletes (such as group membership removals) to Microsoft Entra ID.@@ -28,7 +30,7 @@ You can still migrate in phases, such as by OU or another defined batch. Each ba |Step|Description| |-----|-----| |Choose the best sync tool|Before moving to cloud sync, you should verify that cloud sync is currently the best synchronization tool for you. You can do this task by reviewing the [supported sync scenarios comparison](../common-scenarios.md).|-|Verify the pre-requisites for migrating|The following guidance is only for users who have installed Microsoft Entra Connect using the Express settings and aren't synchronizing devices. Also you should verify the cloud sync [pre-requisites](how-to-prerequisites.md).|+|Verify the prerequisites for migrating|This guidance is for users who installed Microsoft Entra Connect by using Express settings. If you synchronize devices for Microsoft Entra hybrid join, include [device sync](device-sync.md) in your Cloud Sync migration plan. Also verify the [Cloud Sync prerequisites](how-to-prerequisites.md).| |Back up your Microsoft Entra Connect configuration|Before making any changes, you should back up your Microsoft Entra Connect configuration. This way, you can rollback. For more information, see [Import and export Microsoft Entra Connect configuration settings](../connect/how-to-connect-import-export-config.md).| |Review the migration tutorial|To become familiar with the migration process, review the [Migrate to Microsoft Entra Cloud Sync for an existing synced AD forest](tutorial-pilot-aadc-aadccp.md) tutorial. This tutorial guides you through the migration process in a sandbox environment.| |Create or identify an OU for the migration|Create a new OU or identify an existing OU that contains the users you'll test migration on. Keep this OU in Microsoft Entra Connect Sync scope during migration.| 