Document Details
Troubleshoot Failed State
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
Detected Bias Types
powershell_heavy
windows_tools
missing_linux_example
windows_first
Summary
The documentation exclusively uses Azure PowerShell cmdlets for all troubleshooting steps, with instructions to install and use PowerShell. There are no examples or guidance for Linux/macOS users using Azure CLI, Bash, or other cross-platform tools. The workflow assumes a PowerShell environment, which is native to Windows and less common on Linux/macOS. This creates friction for non-Windows users and may prevent them from easily following the troubleshooting steps.
Recommendations
- Provide equivalent Azure CLI examples for each resource operation (e.g., az network application-gateway show/update).
- Add a section explaining how to perform these tasks using Bash or shell scripting on Linux/macOS.
- Clarify that Azure PowerShell can be installed on Linux/macOS, but highlight CLI alternatives for users who prefer them.
- Present both PowerShell and CLI examples side-by-side or allow users to select their preferred environment.
- Mention prerequisites for Linux/macOS users, such as installing PowerShell Core or Azure CLI.
Create Pull Request
Scan History
| Date | Scan | Status | Result |
|---|---|---|---|
| 2026-01-12 00:00 | #99 | completed |
Biased
|
| 2026-01-11 06:20 | #98 | completed |
Biased
|
| 2026-01-10 00:00 | #92 | completed |
 Clean
|
| 2026-01-06 22:28 | #78 | completed |
Clean
|
| 2025-12-15 00:00 | #7 | completed |
Clean
|
| 2025-12-14 05:05 | #6 | completed |
Clean
|