Microsoft Entra ID
TroubleshootingMicrosoft Entra Cloud Sync troubleshooting
In brief
The troubleshooting article no longer documents the Repair-AADCloudSyncToolsAccount cmdlet or its usage steps.
What Entra admins need to know
Administrators should not rely on this obsolete cmdlet when troubleshooting cloud sync.
This editorial summary was generated by AI from the documentation changes. Verify important details in the full Microsoft Learn article.
Documentation change
View on Microsoft LearnThe comparison below shows only the changed extract. Use the full-page view for complete context.
Cloud sync troubleshooting
If you run the first query again, you should see that the service principal has been restored in your tenant. After this, it may take up to 24 hours for the authorization errors to go away completely and for synchronization to resume as normal. If the errors persist beyond that point, reach out to support for further assistance.
Repair the cloud sync service account
If you need to repair the cloud sync service account, you can use the Repair-AADCloudSyncToolsAccount command.
From a PowerShell session with administrative privileges, type, or copy and paste, the following:Connect-AADCloudSyncToolsEnter your Microsoft Entra Global Administrator credentials.Type, or copy and paste, the following:Repair-AADCloudSyncToolsAccountAfter this completes, it should say that the account was repaired successfully.
Password writeback
To enable and use password writeback with cloud sync, keep the following in mind:
@@ -1,10 +1,10 @@ --- title: Microsoft Entra Cloud Sync troubleshooting description: This article describes how to troubleshoot problems that might arise with the cloud provisioning agent.-ms.date: 04/09/2025+ms.date: 08/21/2026 ms.topic: troubleshooting ms.subservice: hybrid-cloud-sync-ms.custom: sfi-ga-nochange, sfi-image-nochange+ms.custom: sfi-ga-nochange, sfi-image-nochange, msecd-doc-authoring-1024 --- # Cloud sync troubleshooting@@ -255,28 +255,6 @@ Request body: If you run the first query again, you should see that the service principal has been restored in your tenant. After this, it may take up to 24 hours for the authorization errors to go away completely and for synchronization to resume as normal. If the errors persist beyond that point, reach out to support for further assistance. -## Repair the cloud sync service account--If you need to repair the cloud sync service account, you can use the `Repair-AADCloudSyncToolsAccount` command.-- 1. [Install the AADCloudSyncTools PowerShell module](reference-powershell.md#install-the-aadcloudsynctools-powershell-module).-- 1. From a PowerShell session with administrative privileges, type, or copy and paste, the following:-- ```powershell- Connect-AADCloudSyncTools- ```-- 1. Enter your Microsoft Entra Global Administrator credentials.-- 1. Type, or copy and paste, the following:-- ```powershell- Repair-AADCloudSyncToolsAccount- ```-- 1. After this completes, it should say that the account was repaired successfully.- ## Password writeback To enable and use password writeback with cloud sync, keep the following in mind: