Document Details
File Sync Planning
❌
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_first
⚠️
missing_linux_example
⚠️
windows_tools
⚠️
powershell_heavy
Summary:
The documentation for Azure File Sync is heavily biased toward Windows environments. It exclusively discusses deployment, management, and compatibility in the context of Windows Server, with no mention of Linux or cross-platform agents. All examples, requirements, and tools (such as PowerShell cmdlets and NTFS-specific features) are Windows-centric. Linux is only briefly mentioned as a client for direct SMB mounting, but not as a participant in Azure File Sync. There are no Linux-specific instructions, tools, or parity in examples.
Recommendations:
- Clearly state early in the documentation that Azure File Sync is only supported on Windows Server, and clarify the lack of Linux agent support.
- If any Linux or cross-platform support is planned or available (even in preview), mention it and provide equivalent instructions or links.
- Where possible, provide parity in examples for direct SMB mounting from Linux (e.g., show how to mount Azure Files using Linux commands such as 'mount -t cifs').
- For management and evaluation tools, mention if there are any CLI or cross-platform alternatives to PowerShell, or clarify that only PowerShell is supported.
- In sections discussing file systems, clarify that NTFS requirements preclude Linux/ext4/xfs support, and explain the rationale.
- If Azure File Sync is fundamentally Windows-only, consider a brief FAQ or callout for Linux users explaining alternatives (such as using direct SMB/NFS mounts or third-party sync tools).
Create pull request
Scan History
| Date | Scan ID | Status | Bias Status |
|---|---|---|---|
| 2025-09-10 00:00 | #107 | completed | ✅ Clean |
| 2025-09-09 00:00 | #106 | 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
$validation = Invoke-AzStorageSyncCompatibilityCheck C:\DATA
$validation.Results | Select-Object -Property Type, Path, Level, Description, Result | Export-Csv -Path C:\results.csv -Encoding utf8
Invoke-AzStorageSyncCompatibilityCheck -Path <path>
Invoke-AzStorageSyncCompatibilityCheck -Path <path> -SkipSystemChecks
Invoke-AzStorageSyncCompatibilityCheck -ComputerName <computer name> -SkipNamespaceChecks