Microsoft Entra ID
General

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.

  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"] Screenshot shows Staging Mode highlighted in the Active Microsoft Entra Connect dialog box.

  1. You need to sign into Microsoft Entra ID with Hybrid Identity Administrator credentials:

[!div class="mx-imgBorder"] Screenshot shows Sign in prompt in the Active Microsoft Entra Connect dialog box.

  1. Tick the box for Staging Mode and select Next:

[!div class="mx-imgBorder"] Screenshot shows Staging Mode configuration in the Active Microsoft Entra Connect dialog box.

  1. 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"] Screenshot shows Ready to Configure screen in the Active Microsoft Entra Connect dialog box.

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.

  1. 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.

  2. 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"] Screenshot shows Sync Service console on the Active Microsoft Entra Connect dialog box.

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.

Select "Configure staging mode" and select Next:

[!div class="mx-imgBorder"] Screenshot shows Staging Mode highlighted in the Staging Microsoft Entra Connect dialog box.

The message at the bottom of the wizard indicates this server is in Staging Mode.

  1. 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"] Screenshot shows Staging Mode configuration in the Staging Microsoft Entra Connect dialog box.

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.

  1. When you're prompted to start the sync process, tick this box and select Configure:

[!div class="mx-imgBorder"] Screenshot shows Ready to Configure screen in the Staging Microsoft Entra Connect dialog box.

  1. Once the process is finished you should get the below confirmation screen where you can select Exit to finish:

[!div class="mx-imgBorder"] Screenshot shows Confirmation screen in the Staging Microsoft Entra Connect dialog box.

Next steps

Overview topics

Daily Entra.News

Get daily email updates

Get a concise summary of the latest Microsoft Entra updates delivered straight to your inbox.

Loading the secure signup form…