Skip to content

Commit ec5cb6b

Browse files
author
Simonx Xu
authored
Merge pull request #8843 from AmandaAZ/Branch-PostEdit
AB#5632: Post Edit for PR#8824
2 parents 1e8c0ad + 13cade8 commit ec5cb6b

File tree

1 file changed

+14
-17
lines changed

1 file changed

+14
-17
lines changed

support/azure/azure-storage/files/file-sync/file-sync-troubleshoot-installation.md

Lines changed: 14 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -3,8 +3,7 @@ title: Troubleshoot Azure File Sync agent installation and server registration
33
description: Troubleshoot common issues with installing the Azure File Sync agent and registering Windows Server with the Storage Sync Service.
44
author: khdownie
55
ms.service: azure-file-storage
6-
ms.topic: troubleshooting
7-
ms.date: 04/29/2025
6+
ms.date: 04/30/2025
87
ms.author: kendownie
98
ms.custom: sap:File Sync
109
---
@@ -175,35 +174,33 @@ When registering a server using *ServerRegistration.exe*, some resource groups a
175174

176175
This issue occurs due to a known issue that has been fixed in File Sync Agent v19.1. To resolve this issue, install the latest version of the agent.
177176

177+
**Server Registration displays the message: "System.Net.Http, Version=4.2.0.0, Culture=neutral, PublicKeyToken=..."**
178178

179+
This error occurs when the server lacks the required .NET Framework version. Azure File Sync's server registration requires .NET Framework 4.7.2 or a later version to function properly.
179180

180-
**Server Registration displays the following message: "System.Net.Http, Version=4.2.0.0, Culture=neutral, PublicKeyToken=..."**
181-
182-
This error occurs when the required version of the .NET Framework is missing on the server. Azure File Sync's server registration requires **.NET Framework 4.7.2. or higher** to function properly.
183-
184-
To resolve the issue:
185-
1. Downland and install .NET Framework 4.7.2. or higher.
186-
2. Restart the server after installation.
187-
3. Retry the server registration using the Server Registration UI or PowerShell.
188-
181+
To resolve the issue, follow these steps:
189182

183+
1. Downland and install .NET Framework 4.7.2 or a later version.
184+
2. Restart the server after the installation.
185+
3. Retry the server registration using the server registration UI or PowerShell.
190186

191187
**Server registration fails with error: operation returned an invalid status code 'Unauthorized'**
192188

193-
During server registration, if you encounter the following error:
194-
`Operation returned an invalid status code 'Unauthorized'`
189+
During server registration, you might encounter the following error:
195190

196-
This issue occurs due to a bug in the Azure File Sync v20 agent. To work around this issue, manually register the server using PowerShell:
191+
> Operation returned an invalid status code 'Unauthorized'
192+
193+
This issue occurs due to a bug in the Azure File Sync v20 agent. To work around this issue, manually register the server by running the following PowerShell commands:
197194

198195
```powershell
199196
Connect-AzAccount -Subscription "<your-subscription-guid>" -Tenant "<your-tenant-guid>"
200197
Register-AzStorageSyncServer -ResourceGroupName "<your-resource-group-name>" -StorageSyncServiceName "<your-storage-sync-service-name>"
201198
```
202199

203-
Replace the placeholder values with your subscription ID, tenant ID, resource group name, and Storage Sync Service name.
204-
205-
After completing the manual registration, verify that the server appears under Registered servers in the Azure portal.
200+
> [!NOTE]
201+
> Replace the placeholder values with your subscription ID, tenant ID, resource group name, and Storage Sync Service name.
206202
203+
After completing the manual registration, verify that the server appears under **Registered servers** in the Azure portal.
207204

208205
<a id="server-already-registered"></a>**Server Registration displays the following message: "This server is already registered"**
209206

0 commit comments

Comments
 (0)