Document Details
Storage Files Migration Overview
❌
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 demonstrates a clear Windows bias. Migration tools and examples are predominantly Windows-centric, with extensive mention of Windows Server, RoboCopy, Azure File Sync, and NTFS/ACLs. Linux is only briefly mentioned, with no detailed migration guides or examples provided for Linux users. The recommended tools and migration paths are almost exclusively tailored for Windows environments, and Windows terminology (e.g., NTFS permissions, SIDs, DACLs) is used throughout without Linux equivalents.
Recommendations:
- Provide equivalent Linux migration examples and guides, especially for common scenarios such as migrating from Linux SMB servers or NAS devices using Linux.
- Include Linux-native tools (e.g., rsync, cifs-utils, smbclient) in the migration toolbox, and discuss their capabilities and limitations with respect to Azure file shares.
- Balance the order of presentation so that Linux and Windows options are given equal prominence in tables and tool recommendations.
- Explain file permission and metadata mapping for Linux (e.g., POSIX ACLs, ownership, timestamps) and how they are preserved or mapped in Azure file shares.
- Add detailed step-by-step migration guides for Linux environments, similar to those provided for Windows (e.g., mounting Azure file shares on Linux, copying data, preserving metadata).
- Clarify limitations or special considerations for Linux users, such as differences in metadata support or authentication methods.
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-19 00:01 | #85 | completed | ✅ Clean |
| 2025-07-16 00:00 | #52 | completed | ❌ Biased |
| 2025-07-13 21:37 | #48 | completed | ❌ Biased |
| 2025-07-12 23:44 | #41 | in_progress | ❌ Biased |