Skip to main content

The Microsoft Entra Connect Sync server has problems. The good thing is that we have another healthy server with Microsoft Entra Connect Sync installed. We will enable staging mode on the failing server so it will not do any syncing between on-premises AD and Microsoft Entra ID. On the healthy server, we will disable staging mode so it starts syncing to Microsoft Entra ID. In this article, you will learn how to enable and disable Microsoft Entra Connect Sync staging mode.

What is staging mode?

With a Microsoft Entra Connect Sync server in staging mode, you can make changes to the configuration and preview the changes before you make the server active. It also allows you to run full import and full synchronization to verify that all changes are expected before you make these changes into your production environment.

You can have multiple Microsoft Entra Connect Sync servers deployed in your environment for redundancy purposes. However, only one server at a time can be active and synchronize changes between your on-premises Active Directory and Microsoft Entra ID. The other servers serve as standby instances.

Important: Do not disable staging mode on multiple servers simultaneously. You should only disable it on a single server to sync data between on-premises AD and Microsoft Entra ID.

Enable Microsoft Entra Connect Sync staging mode

Go through the below steps to enable staging mode:

  1. Start Microsoft Entra Connect Sync.
  2. Click on Configure
  3. Select Configure staging mode.
  4. Click Next.
Microsoft Entra Connect Sync configure staging mode
  1. Fill in the Azure AD global administrator or hybrid identity administrator credentials.
  2. Click Next.
Microsoft Entra Connect Sync connect to Entra ID
  1. Check the checkbox Enable staging mode.
  2. Click Next.
Microsoft Entra Connect Sync enable staging mode
  1. Check the checkbox Start the synchronization process when configuration completes.
  2. Click Configure.
Microsoft Entra Connect Sync ready to configure
  1. Staging mode is successfully enabled on the failing server.
  2. Click Exit.
Staging mode has been successfully enabled

Disable Microsoft Entra Connect Sync staging mode

Go through the below steps to disable staging mode:

  1. Start Microsoft Entra Connect Sync.
  2. Click on Configure
  3. Select Configure staging mode.
  4. Click Next.
  1. Fill in the Azure AD global administrator or hybrid identity administrator credentials.
  2. Click Next.
  1. Uncheck the checkbox Enable staging mode.
  2. Click Next.
Microsoft Entra Connect Sync disable staging mode
  1. Check the checkbox Start the synchronization process when configuration completes.
  2. Click Configure.
  1. Staging mode is successfully disabled on the healthy server.
  2. Click Exit.
Staging mode has been successfully disabled

Get Microsoft Entra Connect Sync staging mode status with PowerShell

Run the below commands to check the current Microsoft Entra Connect Sync staging mode status.

$ADSyncSettings = Get-ADSyncGlobalSettings
($ADSyncSettings.parameters | Where-Object { $_.Name -eq "Microsoft.Synchronize.StagingMode" }).value

One of the results will appear:

  • True: Staging mode is enabled
  • False: Staging mode is disabled

Enable Microsoft Entra Connect Sync staging mode with PowerShell

To turn on Microsoft Entra Connect Sync staging mode in PowerShell, run the below commands.

$ADSyncSettings = Get-ADSyncGlobalSettings
($ADSyncSettings.parameters | Where-Object { $_.Name -eq "Microsoft.Synchronize.StagingMode" }).value = "True"
Set-ADSyncGlobalSettings $ADSyncSettings

Disable Microsoft Entra Connect Sync staging mode with PowerShell

To turn off Microsoft Entra Connect Sync staging mode in PowerShell, run the below commands.

$ADSyncSettings = Get-ADSyncGlobalSettings
($ADSyncSettings.parameters | Where-Object { $_.Name -eq "Microsoft.Synchronize.StagingMode" }).value = "False"
Set-ADSyncGlobalSettings $ADSyncSettings

That’s it!

Leave a Reply