Document Details
Common Questions Appliance
❌
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:
⚠️
powershell_heavy
⚠️
windows_first
⚠️
windows_tools
⚠️
missing_linux_example
Summary:
The documentation for the Azure Migrate appliance demonstrates a strong Windows bias. Deployment and management instructions are centered around PowerShell scripts, with no mention of Bash or Linux-native alternatives. Troubleshooting and certificate management steps are exclusively shown using Windows UI tools (e.g., Certificate Manager, Group Policy Editor), and all screenshots are from Windows environments. There are no examples or instructions for deploying, managing, or troubleshooting the appliance from a Linux or cross-platform perspective, despite the appliance being able to discover Linux servers. Linux tools, commands, or workflows are not mentioned, and Windows-specific paths and patterns (e.g., %ProgramData%, C:\Program Files) are used throughout.
Recommendations:
- Provide equivalent Bash or shell script instructions for deploying and managing the appliance on Linux-based hosts, or clarify if only Windows is supported for appliance management.
- Include troubleshooting steps and screenshots for certificate validation and MSI signature checking on Linux (e.g., using openssl, certutil, or other Linux tools).
- Document how to perform appliance updates, certificate management, and log collection on Linux-based appliances, if supported.
- When referencing file paths or environment variables, include Linux equivalents (e.g., /var/lib/, /opt/, $HOME) alongside Windows paths.
- Explicitly state OS requirements and clarify if the appliance or its management tools are Windows-only, or provide Linux support guidance if available.
- Add examples and guidance for Linux administrators, including how to provide Linux credentials, manage agent health, and troubleshoot common issues from a Linux perspective.
Create pull request
Scan History
| Date | Scan ID | Status | Bias Status |
|---|---|---|---|
| 2025-08-17 00:01 | #83 | in_progress | ✅ Clean |
| 2025-07-13 21:37 | #48 | completed | ❌ Biased |
| 2025-07-12 23:44 | #41 | in_progress | ❌ Biased |
| 2025-07-09 13:09 | #3 | cancelled | ✅ Clean |
| 2025-07-08 04:23 | #2 | cancelled | ❌ Biased |