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
Bias Types:
⚠️
powershell_heavy
⚠️
windows_tools
⚠️
missing_linux_example
⚠️
windows_first
Summary:
The documentation page exclusively uses Azure PowerShell cmdlets for all troubleshooting examples, with instructions to install and use PowerShell, and no mention of Azure CLI, Bash, or cross-platform alternatives. This approach assumes the user is on Windows or is comfortable with PowerShell, which is less common on Linux systems. There are no Linux-specific or cross-platform instructions or examples provided.
Recommendations:
- Add equivalent Azure CLI (az) command examples for each resource type, as Azure CLI is cross-platform and widely used on Linux and macOS.
- Include a section on how to install and use Azure CLI, similar to the PowerShell installation instructions.
- Where possible, provide Bash script examples alongside PowerShell, or at least clarify that PowerShell Core is available cross-platform.
- Rephrase instructions to be tool-agnostic where possible (e.g., 'Use Azure PowerShell or Azure CLI to...').
- List both PowerShell and CLI examples side-by-side, or allow users to select their preferred shell in the documentation UI.
- Explicitly state that the instructions apply to both Windows and Linux, and highlight any differences in behavior or prerequisites.
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 | ✅ Clean |
| 2025-07-12 23:44 | #41 | in_progress | ❌ Biased |
Flagged Code Snippets
> [!NOTE]
> Most Virtual WAN related resources, such as virtualHubs, use the `Update` cmdlet, not the `Set`, for write operations.
### Microsoft.Network/virtualNetworkGateways
> [!NOTE]
> Most Virtual WAN related resources, such as virtualWans, use the `Update` cmdlet, not the `Set`, for write operations.
### Microsoft.Network/vpnGateways
> [!NOTE]
> Most Virtual WAN related resources, such as networkVirtualAppliances, use the `Update` cmdlet, not the `Set`, for write operations.
### Microsoft.Network/privateDnsZones