Skip to content

Commit ceba92f

Browse files
authored
Merge pull request #9359 from MicrosoftDocs/rladbsal-patch-4
Update file-sync-troubleshoot-managed-identities.md
2 parents 238ede3 + 2f88c92 commit ceba92f

File tree

1 file changed

+20
-1
lines changed

1 file changed

+20
-1
lines changed

support/azure/azure-storage/files/file-sync/file-sync-troubleshoot-managed-identities.md

Lines changed: 20 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: Troubleshoot Azure File Sync managed identity issues
33
description: Troubleshoot common issues when your Azure File Sync deployment is configured to use managed identities.
44
ms.service: azure-file-storage
55
ms.topic: troubleshooting
6-
ms.date: 06/09/2025
6+
ms.date: 07/16/2025
77
author: khdownie
88
ms.author: kendownie
99
---
@@ -169,6 +169,25 @@ Set-AzStorageSyncServerEndpointPermission -ResourceGroupName <string> -StorageSy
169169
> [!NOTE]
170170
> The `-Name` parameter is the name of the server endpoint. It's a GUID, not the friendly name that's displayed in the Azure portal. To get the server endpoint name, run the [Get-AzStorageSyncServerEndpoint](/powershell/module/az.storagesync/get-azstoragesyncserverendpoint) cmdlet.
171171
172+
173+
### Sync Session fails with ECS_E_AUTH_IDENTITY_NOT_FOUND error
174+
175+
The `ECS_E_AUTH_IDENTITY_NOT_FOUND` error occurs when the server's managed identity used to communicate with the Azure File Sync service has changed, but the Azure File Sync service is still expecting the previous identity. This can result in authentication failures.
176+
177+
You can identify this issue by checking for **Event ID 9530** in the **Telemetry** event log within **Event Viewer**. This event indicates that the managed identity's `applicationId` has changed.
178+
179+
Common scenarios that can trigger this issue include:
180+
- Azure Arc resource deletion and recreation
181+
- Toggling the system-assigned managed identity on an Azure VM off and then back on
182+
183+
When the managed identity changes, the File Sync agent will attempt to use the new identity, but the Azure File Sync service is still configured to authorize the previous one. This mismatch causes requests to fail with the `ECS_E_AUTH_IDENTITY_NOT_FOUND` error.
184+
185+
To resolve this issue, run the following PowerShell command:
186+
187+
```powershell
188+
Set-AzStorageSyncServer -ResourceGroupName <ResourceGroupName> -StorageSyncServiceName <StorageSyncServiceName> -Identity
189+
```
190+
172191
### Test-NetworkConnectivity cmdlet fails with error 0x80190193 (HTTP_E_STATUS_FORBIDDEN)
173192

174193
This issue occurs when the managed identity for the registered server doesn't have access to an Azure file share.

0 commit comments

Comments
 (0)