Connect Sync Staging Server
In brief
The Microsoft Entra Connect staging server guide received formatting cleanup, including corrected list structure and link spacing.
What Entra admins need to know
The procedure is easier to scan and follow; no administrator action is indicated.
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.
When the synchronization cycle is enabled, a server in staging mode continues to receive changes from Active Directory and Microsoft Entra ID. It can quickly take over the responsibilities of another server in the event of a failure. Although you can manually force an export by using Synchronization Service Manager, exporting changes from a staging server isn't supported. Having more than one active Microsoft Entra Connect Sync server for the same Microsoft Entra tenant also isn't supported.
For those of you with knowledge of older sync technologies, the staging mode is different since the server has its own SQL database. This architecture allows the staging mode server to be located in a different datacenter.
- One staging Microsoft Entra Connect Sync Server
- The staging server has the synchronization scheduler enabled and has synchronized with Microsoft Entra ID recently
- In case of any updates in synchronization rules or in sync scope, run an initial sync cycle
- Confirm that your Microsoft Entra Connect Sync Server is configured to prevent accidental deletes
- Verifythe pending exports and confirm that there aren't significant updates, and such updates are expected
- Check if Microsoft Entra Connect Health agent is updated by checking the server in Microsoft Entra Connect Health portal
- Switch the current active server to staging mode, before switching the staging server to active
We need to ensure that only one Sync Server is syncing changes at any given time throughout this process. If the currently active Sync Server is reachable, you can perform the below steps to move it to Staging Mode. If it isn't reachable, ensure that the server or VM doesn't regain access unexpectedly either by shutting down the server or isolating it from outbound connections.
- For the currently active Microsoft Entra Connect server, open the Microsoft Entra Connect wizard and select "Configure staging mode" then Next:
[!div class="mx-imgBorder"]
- You need to sign into Microsoft Entra ID with Hybrid Identity Administrator credentials:
[!div class="mx-imgBorder"]
- Tick the box for Staging Mode and select Next:
[!div class="mx-imgBorder"]
- The Microsoft Entra Connect server checks for installed components and then prompt you whether you want to start the sync process when the configuration change completes:
[!div class="mx-imgBorder"]
Since the server is in staging mode, it won't write changes to Microsoft Entra ID, but retains any changes to the AD in its Connector Space, ready to write them. It's recommended to leave the sync process on for the server in Staging Mode, so if it becomes active, it will quickly take over and won't have to do a large sync to catch up to the current state of the Active Directory / Microsoft Entra objects in scope.
After selecting to start the sync process and selecting Configure, the Microsoft Entra Connect server is configured into Staging Mode. Once completed, a screen prompts you confirming the Staging Mode is enabled. You can select Exit to finish.
You can confirm that the server is successfully in Staging Mode by opening Windows PowerShell, load the "ADSync" module and verify the ADSync Scheduler configuration, using the following commands:
Import-Module ADSync
Get-ADSyncScheduler
From the results, verify the value of the "StagingModeEnabled" setting. If the server was successfully switched to staging mode, the value of this setting should be True like in the following example:
[!div class="mx-imgBorder"]
We can now move our Staging Sync Server to Active mode and actively sync changes.
- Now move to the Microsoft Entra Connect server that was originally in Staging Mode and open the Microsoft Entra Connect wizard.
Select "Configure staging mode" and select Next:
[!div class="mx-imgBorder"]
The message at the bottom of the wizard indicates this server is in Staging Mode.
- Sign into Microsoft Entra ID, then go to the Staging Mode screen.
Untick the box for Staging Mode and select Next.
[!div class="mx-imgBorder"]
As per the warning on this page, it's important to ensure no other Microsoft Entra Connect server is actively syncing.
There should only be one active Microsoft Entra Connect Sync server at any time.
- When you're prompted to start the sync process, tick this box and select Configure:
[!div class="mx-imgBorder"]
- Once the process is finished you should get the below confirmation screen where you can select Exit to finish:
[!div class="mx-imgBorder"]
Next steps
Overview topics
@@ -29,7 +29,7 @@ When staging mode is disabled, password sync resumes from the last recorded wate > [!WARNING] > Password sync catch-up can take an extended period of time after disabling staging mode. **Do not restart the sync services during catch-up** — stopping the service can cause PHS to resume from an earlier watermark when it starts again, which increases the time to become current.-> + When the synchronization cycle is enabled, a server in staging mode continues to receive changes from Active Directory and Microsoft Entra ID. It can quickly take over the responsibilities of another server in the event of a failure. Although you can manually force an export by using **Synchronization Service Manager**, exporting changes from a staging server isn't supported. Having more than one active Microsoft Entra Connect Sync server for the same Microsoft Entra tenant also isn't supported. For those of you with knowledge of older sync technologies, the staging mode is different since the server has its own SQL database. This architecture allows the staging mode server to be located in a different datacenter.@@ -108,8 +108,8 @@ You may need to perform a failover of the Sync Servers for several reasons, such - One staging Microsoft Entra Connect Sync Server - The staging server has the synchronization scheduler enabled and has synchronized with Microsoft Entra ID recently - In case of any updates in synchronization rules or in sync scope, run an initial sync cycle-- Confirm that your Microsoft Entra Connect Sync Server is configured to [prevent accidental deletes](how-to-connect-sync-feature-prevent-accidental-deletes.md) -- [Verify ](#verify)the pending exports and confirm that there aren't significant updates, and such updates are expected+- Confirm that your Microsoft Entra Connect Sync Server is configured to [prevent accidental deletes](how-to-connect-sync-feature-prevent-accidental-deletes.md)+- [Verify](#verify)the pending exports and confirm that there aren't significant updates, and such updates are expected - Check if [Microsoft Entra Connect Health](whatis-azure-ad-connect.md#what-is-microsoft-entra-connect-health) agent is updated by checking the server in [Microsoft Entra Connect Health](https://aka.ms/aadconnecthealth) portal - Switch the current active server to staging mode, before switching the staging server to active @@ -117,31 +117,31 @@ You may need to perform a failover of the Sync Servers for several reasons, such We need to ensure that only one Sync Server is syncing changes at any given time throughout this process. If the currently active Sync Server is reachable, you can perform the below steps to move it to Staging Mode. If it isn't reachable, ensure that the server or VM doesn't regain access unexpectedly either by shutting down the server or isolating it from outbound connections. -1. For the currently active Microsoft Entra Connect server, open the Microsoft Entra Connect wizard and select "Configure staging mode" then Next: +1. For the currently active Microsoft Entra Connect server, open the Microsoft Entra Connect wizard and select "Configure staging mode" then Next: > [!div class="mx-imgBorder"] >  -2. You need to sign into Microsoft Entra ID with Hybrid Identity Administrator credentials: +2. You need to sign into Microsoft Entra ID with Hybrid Identity Administrator credentials: > [!div class="mx-imgBorder"] >  -3. Tick the box for Staging Mode and select Next: +3. Tick the box for Staging Mode and select Next: > [!div class="mx-imgBorder"] >  -4. The Microsoft Entra Connect server checks for installed components and then prompt you whether you want to start the sync process when the configuration change completes: +4. The Microsoft Entra Connect server checks for installed components and then prompt you whether you want to start the sync process when the configuration change completes: > [!div class="mx-imgBorder"]->  +>  -Since the server is in staging mode, it won't write changes to Microsoft Entra ID, but retains any changes to the AD in its Connector Space, ready to write them. +Since the server is in staging mode, it won't write changes to Microsoft Entra ID, but retains any changes to the AD in its Connector Space, ready to write them. It's recommended to leave the sync process on for the server in Staging Mode, so if it becomes active, it will quickly take over and won't have to do a large sync to catch up to the current state of the Active Directory / Microsoft Entra objects in scope. -5. After selecting to start the sync process and selecting Configure, the Microsoft Entra Connect server is configured into Staging Mode. -Once completed, a screen prompts you confirming the Staging Mode is enabled. +5. After selecting to start the sync process and selecting Configure, the Microsoft Entra Connect server is configured into Staging Mode.+Once completed, a screen prompts you confirming the Staging Mode is enabled. You can select Exit to finish. 6. You can confirm that the server is successfully in Staging Mode by opening Windows PowerShell, load the "ADSync" module and verify the ADSync Scheduler configuration, using the following commands:@@ -149,9 +149,9 @@ You can select Exit to finish. ```powershell Import-Module ADSync Get-ADSyncScheduler-``` - -From the results, verify the value of the "StagingModeEnabled" setting. If the server was successfully switched to staging mode, the value of this setting should be ***True*** like in the following example: +```++From the results, verify the value of the "StagingModeEnabled" setting. If the server was successfully switched to staging mode, the value of this setting should be ***True*** like in the following example: > [!div class="mx-imgBorder"] > @@ -164,32 +164,32 @@ At this point, all of our Microsoft Entra Connect Sync Servers should be in Stag We can now move our Staging Sync Server to Active mode and actively sync changes. -1. Now move to the Microsoft Entra Connect server that was originally in Staging Mode and open the Microsoft Entra Connect wizard. +1. Now move to the Microsoft Entra Connect server that was originally in Staging Mode and open the Microsoft Entra Connect wizard. - Select "Configure staging mode" and select Next: + Select "Configure staging mode" and select Next: > [!div class="mx-imgBorder"]->  +>  The message at the bottom of the wizard indicates this server is in Staging Mode. 2. Sign into Microsoft Entra ID, then go to the Staging Mode screen. - Untick the box for Staging Mode and select Next. + Untick the box for Staging Mode and select Next. > [!div class="mx-imgBorder"]->  +>  - As per the warning on this page, it's important to ensure no other Microsoft Entra Connect server is actively syncing. + As per the warning on this page, it's important to ensure no other Microsoft Entra Connect server is actively syncing. There should only be one active Microsoft Entra Connect Sync server at any time. -3. When you're prompted to start the sync process, tick this box and select Configure: +3. When you're prompted to start the sync process, tick this box and select Configure: > [!div class="mx-imgBorder"] >  -4. Once the process is finished you should get the below confirmation screen where you can select Exit to finish: +4. Once the process is finished you should get the below confirmation screen where you can select Exit to finish: > [!div class="mx-imgBorder"] > @@ -391,7 +391,7 @@ else ## Next steps -**Overview topics** +**Overview topics** -* [Microsoft Entra Connect Sync: Understand and customize synchronization](how-to-connect-sync-whatis.md) -* [Integrating your on-premises identities with Microsoft Entra ID](../whatis-hybrid-identity.md) +* [Microsoft Entra Connect Sync: Understand and customize synchronization](how-to-connect-sync-whatis.md)+* [Integrating your on-premises identities with Microsoft Entra ID](../whatis-hybrid-identity.md) 








