Document Details
Troubleshoot Network Connectivity
❌
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
⚠️
powershell_heavy
⚠️
missing_linux_example
⚠️
windows_tools
Summary:
The documentation demonstrates a Windows bias by providing command-line examples (such as nslookup) with Windows-style prompts (e.g., 'c:\ >nslookup'), referencing PowerShell-specific tools like Test-NetConnection, and omitting equivalent Linux/macOS commands or instructions. The guidance for editing the hosts file and DNS troubleshooting is written from a Windows perspective, with no mention of Linux file paths or tools (e.g., /etc/hosts, dig, or host commands). This may hinder users operating Azure Migrate appliances on Linux or mixed environments.
Recommendations:
- Provide Linux/macOS equivalents for all command-line examples (e.g., show both 'nslookup' and 'dig' or 'host' commands, with appropriate shell prompts).
- When referencing PowerShell-specific tools like Test-NetConnection, also mention cross-platform alternatives such as 'telnet', 'nc' (netcat), or 'curl' for port connectivity tests.
- Include instructions for editing the hosts file on Linux (/etc/hosts) and macOS, not just Windows (C:\Windows\System32\drivers\etc\hosts).
- Use neutral command prompts (e.g., '$' for shell, or generic 'command line') instead of Windows-specific prompts.
- Explicitly state that the troubleshooting steps apply to both Windows and Linux appliances, and clarify any differences in procedure.
- Add screenshots or terminal output examples from Linux environments where appropriate.
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 |