Document Details
General
❌
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
⚠️
missing_linux_example
⚠️
windows_tools
Summary:
The documentation page demonstrates a Windows bias in several ways: PowerShell is the only CLI example provided for duplicating policy definitions, with no Bash, Azure CLI, or cross-platform alternatives. References to 'Azure PowerShell' for on-demand evaluation scans are made repeatedly, but no equivalent Azure CLI or REST examples are shown. The documentation assumes the use of Windows-centric tools and patterns (such as PowerShell and Visual Studio Code) and does not provide parity for Linux or macOS users. This may hinder users on non-Windows platforms from following the troubleshooting steps effectively.
Recommendations:
- For every PowerShell example, provide an equivalent Azure CLI (az) or Bash example, especially for common tasks like duplicating policy definitions or triggering evaluation scans.
- When referencing 'Azure PowerShell or the REST API', explicitly include Azure CLI commands and examples, or link to relevant cross-platform documentation.
- Mention cross-platform editors (such as VS Code, which is cross-platform) but clarify that the Azure Policy extension works on all supported OSes.
- Audit all troubleshooting steps to ensure that Linux/macOS users are not excluded, and add notes or examples where platform-specific differences exist.
- Where possible, use generic REST API calls or platform-neutral scripting in examples, or provide both PowerShell and Bash/Azure CLI snippets side by side.
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
# duplicates the built-in policy which audits Windows machines for pending reboots
$def = Get-AzPolicyDefinition -id "/providers/Microsoft.Authorization/policyDefinitions/4221adbc-5c0f-474f-88b7-037a99e6114c"
New-AzPolicyDefinition -name (new-guid).guid -DisplayName "$($def.DisplayName) (Copy)" -Description $def.Description -Metadata ($def.Metadata | convertto-json) -Parameter ($def.Parameter | convertto-json) -Policy ($def.PolicyRule | convertto-json -depth 15)