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
⚠️
powershell_heavy
⚠️
windows_tools
⚠️
missing_linux_example
Summary:
The documentation demonstrates a Windows bias in several ways: Windows Server is the only supported OS for the Azure Migrate appliance, with explicit instructions and examples using Windows tools (PowerShell, CertUtil, IIS, registry edits). The setup and installation process is described exclusively with Windows commands and patterns, with no equivalent Linux instructions or support. While Linux server discovery is mentioned, there are no examples or guidance for running the appliance or installer on Linux, nor are Linux-native tools referenced.
Recommendations:
- Provide parity by supporting and documenting installation of the Azure Migrate appliance on Linux hosts, or explicitly state if this is not possible.
- Include Linux shell (bash) equivalents for all PowerShell and Windows command-line examples, or clarify that the appliance is Windows-only.
- Reference Linux-native tools (e.g., sha256sum for hash verification) alongside Windows tools like CertUtil.
- If the appliance cannot run on Linux, explain the rationale and suggest best practices for mixed-OS environments.
- Ensure that all steps involving Windows-specific features (IIS, registry, PowerShell ISE) are either accompanied by Linux alternatives or clearly marked as Windows-only requirements.
- Consider restructuring sections so that Linux and Windows instructions are presented in parallel where possible, rather than Windows-first.
Create pull request