Document Details
File Sync Extension
❌
This page contains Windows bias
About This Page
This page is part of the Azure documentation. It contains code examples and configuration instructions for working with Azure services.
Bias Analysis
Bias Types:
⚠️
windows_only
⚠️
missing_linux_example
⚠️
windows_tools
⚠️
windows_first
Summary:
The documentation is exclusively focused on Windows, both in prerequisites and in all provided examples. It explicitly states that Azure File Sync is only supported on Windows, and all instructions, settings, and validation steps refer to Windows-specific tools, paths, and concepts (e.g., C:\ paths, Windows services, Programs and Features). There are no Linux examples, nor any mention of Linux equivalents or alternatives. Windows tools and patterns (such as PowerShell, Windows file paths, and Windows service names) are used throughout, and the documentation does not address Linux users beyond stating lack of support.
Recommendations:
- If Azure File Sync is not supported on Linux, clarify this prominently at the start and suggest alternative solutions for Linux users (such as using Azure File Share with native Linux SMB/NFS clients or third-party sync tools).
- If future Linux support is planned, provide a roadmap or link to updates.
- Where possible, provide parity in documentation by including a section or links for Linux users, even if only to explain why the feature is not available and what alternatives exist.
- Avoid using Windows-specific terminology (such as C:\ paths, Programs and Features, or Windows service names) in general Azure Arc documentation unless the feature is truly Windows-only.
- In cross-platform documentation, always present both Windows and Linux options/examples, or clearly indicate when a feature is platform-specific.
Create pull request
Scan History
| Date | Scan ID | Status | Bias Status |
|---|---|---|---|
| 2025-09-16 00:00 | #113 | completed | ✅ Clean |
| 2025-09-15 00:00 | #112 | completed | ✅ Clean |
| 2025-09-14 00:00 | #111 | completed | ✅ Clean |
| 2025-09-13 00:00 | #110 | completed | ✅ Clean |
| 2025-09-12 00:00 | #109 | completed | ✅ Clean |
| 2025-09-11 00:00 | #108 | completed | ✅ Clean |
| 2025-09-10 00:00 | #107 | completed | ✅ Clean |
| 2025-09-09 00:00 | #106 | completed | ✅ Clean |
| 2025-09-08 00:00 | #105 | completed | ✅ Clean |
| 2025-09-07 00:00 | #104 | completed | ✅ Clean |
| 2025-09-06 00:00 | #103 | completed | ✅ Clean |
| 2025-09-05 00:00 | #102 | completed | ✅ Clean |
| 2025-09-04 00:00 | #101 | completed | ✅ Clean |
| 2025-09-03 00:00 | #100 | completed | ✅ Clean |
| 2025-08-29 00:01 | #95 | completed | ✅ Clean |
| 2025-08-22 00:01 | #88 | completed | ✅ Clean |
| 2025-08-19 00:01 | #85 | completed | ✅ Clean |
| 2025-07-13 21:37 | #48 | completed | ❌ Biased |
| 2025-07-12 23:44 | #41 | in_progress | ❌ Biased |
Flagged Code Snippets
$Settings = @{
EnableAgentAutoUpdate = "true"
AutoUpdateScheduledDayOfWeek = "Monday"
AutoUpdateScheduledHourOfDay = 05
EnableServerDiagnostics = "true"
AgentInstallDir = "C:\Custom Path\AFS"
EnrollInMicrosoftUpdate = "true"
}
New-AzConnectedMachineExtension `
-ResourceGroupName <resource-group-name> `
-MachineName <machine-name> `
-Name AzureFileSyncExtension `
-SubscriptionId <subscriptionId> `
-Location <region> `
-TypeHandlerVersion <version> `
-Publisher Microsoft.StorageSync `
-ExtensionType AzureFileSyncExtension `
-Settings $settings
$Settings = @{
EnableAgentAutoUpdate = "true"
AutoUpdateScheduledDayOfWeek = "Monday"
AutoUpdateScheduledHourOfDay = 05
EnableServerDiagnostics = "true"
AgentInstallDir = "C:\Custom Path\AFS"
EnrollInMicrosoftUpdate = "true"
UseCustomProxy = "true"
ProxyAddress = "http://proxy.contoso.com"
ProxyPort = 1009
ProxyAuthRequired = "true"
ProxyUsername = "myuser"
}
$protectedSettings =@{
ProxyPassword = "your_proxy_password"
}
New-AzConnectedMachineExtension `
-ResourceGroupName <resource-group-name> `
-MachineName <machine-name> `
-Name AzureFileSyncExtension `
-SubscriptionId <subscriptionId> `
-Location <region> `
-TypeHandlerVersion <version> `
-Publisher Microsoft.StorageSync `
-ExtensionType AzureFileSyncExtension `
-Settings $settings `
-ProtectedSetting $protectedSettings
{
"EnableAgentAutoUpdate": "true",
"AutoUpdateScheduledDayOfWeek": "Monday",
"AutoUpdateScheduledHourOfDay": 5,
"EnableServerDiagnostics": "true",
"AgentInstallDir": "C:\\Custom Path\\AFS",
"EnrollInMicrosoftUpdate": "true",
"UseCustomProxy": "true",
"ProxyAddress": "http://proxy.contoso.com",
"ProxyPort": 1009,
"ProxyAuthRequired": "true",
"ProxyUsername": "your_username"
}
New-AzResourceGroupDeployment -ResourceGroupName "<ResourceGroupName>" -TemplateFile "template.json" -TemplateParameterFile "parameters.json"
az connectedmachine extension create \
--name AzureFileSyncAgentExtension \
--machine-name <machine> \
--resource-group <machine rg> \
--publisher Microsoft.StorageSync \
--type AzureFileSyncAgentExtension \
--settings "afs_settings.json" \
--protected-settings "afs_pwd.json"
{
"$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentParameters.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"AgentInstallDir": { "value": "C:\\Program Files\\Azure\\StorageSyncAgent\\" },
"UseCustomProxy": { "value": true },
"ProxyAddress": { "value": "http://proxy.contoso.com" },
"ProxyPort": { "value": "80" },
"ProxyAuthRequired": { "value": true },
"ProxyUserName": { "value": "ProxyUserName" },
"ProxyPassword": { "value": "ProxyPassword" },
"EnrollInMicrosoftUpdate": { "value": true },
"EnableAgentAutoUpdate": { "value": true },
"AutoUpdateScheduledDayOfWeek": { "value": "Monday" },
"AutoUpdateScheduledHourOfDay": { "value": "23" },
"EnableServerDiagnostics": { "value": true },
"vmName": { "value": "ArcVM1" },
"location": { "value": "eastus2euap" }
}
}
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"contentVersion": "0.43.0.0",
"parameters": {
"vmName": { "type": "string" },
"location": { "type": "string" },
"agentInstallDir": { "type": "string", "defaultValue": "C:\\Program Files\\Azure\\StorageSyncAgent\\" },
"useCustomProxy": { "type": "bool", "defaultValue": false },
"proxyAddress": { "type": "string", "defaultValue": "" },
"proxyPort": { "type": "string", "defaultValue": "0" },
"proxyAuthRequired": { "type": "bool", "defaultValue": false },
"proxyUsername": { "type": "string", "defaultValue": "" },
"proxyPassword": { "type": "securestring", "defaultValue": "" },
"enrollInMicrosoftUpdate": { "type": "bool", "defaultValue": true },
"enableAgentAutoUpdate": { "type": "bool", "defaultValue": false },
"autoUpdateScheduledDayOfWeek": { "type": "string", "defaultValue": "Tuesday" },
"autoUpdateScheduledHourOfDay": { "type": "string", "defaultValue": "18" },
"enableServerDiagnostics": { "type": "bool", "defaultValue": true }
},
"variables": {
"AgentInstallDir": "[parameters('agentInstallDir')]",
"UseCustomProxy": "[parameters('useCustomProxy')]",
"ProxyAddress": "[parameters('proxyAddress')]",
"ProxyPort": "[int(parameters('proxyPort'))]",
"ProxyAuthRequired": "[parameters('proxyAuthRequired')]",
"ProxyUserName": "[parameters('proxyUserName')]",
"ProxyPassword": "[parameters('proxyPassword')]",
"EnrollInMicrosoftUpdate": "[parameters('enrollInMicrosoftUpdate')]",
"EnableAgentAutoUpdate": "[parameters('enableAgentAutoUpdate')]",
"AutoUpdateScheduledDayOfWeek": "[parameters('autoUpdateScheduledDayOfWeek')]",
"AutoUpdateScheduledHourOfDay": "[parameters('autoUpdateScheduledHourOfDay')]",
"EnableServerDiagnostics": "[parameters('enableServerDiagnostics')]"
},
"resources": [
{
"name": "[concat(parameters('vmName'),'/AzureFileSyncAgentExtension')]",
"type": "Microsoft.HybridCompute/machines/extensions",
"location": "[parameters('location')]",
"apiVersion": "2021-05-20",
"properties": {
"publisher": "Microsoft.StorageSync",
"type": "AzureFileSyncAgentExtension",
"autoUpgradeMinorVersion": true,
"enableAutomaticUpgrade": true,
"settings": {
"agentInstallDir": "[variables('AgentInstallDir')]",
"useCustomProxy": "[variables('UseCustomProxy')]",
"proxyAddress": "[variables('ProxyAddress')]",
"proxyPort": "[variables('ProxyPort')]",
"proxyAuthRequired": "[variables('ProxyAuthRequired')]",
"proxyUsername": "[variables('ProxyUserName')]",
"enrollInMicrosoftUpdate": "[variables('EnrollInMicrosoftUpdate')]",
"enableAgentAutoUpdate": "[variables('EnableAgentAutoUpdate')]",
"autoUpdateScheduledDayOfWeek": "[variables('AutoUpdateScheduledDayOfWeek')]",
"autoUpdateScheduledHourOfDay": "[variables('AutoUpdateScheduledHourOfDay')]",
"enableServerDiagnostics": "[variables('EnableServerDiagnostics')]"
},
"protectedSettings": {
"proxyPassword": "[parameters('proxyPassword')]"
}
}
}
]
}
Get-AzConnectedMachineExtension `
-ResourceGroupName <resource-group-name> `
-MachineName <machine-name> `
-Name <EXTENSION_NAME>
Remove-AzConnectedMachineExtension `
-MachineName <machine-name> `
-ResourceGroupName <resource-group-name> `
-Name <EXTENSION_NAME>