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
⚠️ windows_tools
⚠️ missing_linux_example
Summary:
The documentation demonstrates a Windows bias in several ways: PowerShell examples are provided before Azure CLI examples, and the PowerShell examples use Windows-style file paths (e.g., 'c:\policies\coolAccessTier.json') without Linux alternatives. There is no mention of Linux-specific shell usage or file path conventions, and no explicit Bash or Linux terminal examples are given. The documentation assumes familiarity with Windows tools and patterns, which may hinder Linux users.
Recommendations:
  • Provide Azure CLI and PowerShell examples side-by-side or alternate their order to avoid always presenting PowerShell (Windows) first.
  • Include Linux/Bash-specific examples, especially for file paths (e.g., use '/home/user/policies/coolAccessTier.json' alongside 'c:\policies\coolAccessTier.json').
  • Explicitly mention that Azure CLI works cross-platform and show usage in a Bash shell or terminal.
  • Where file paths are shown, provide both Windows and Linux/Mac formats.
  • Reference Linux and MacOS environments in prerequisites and tool installation steps.
  • Add notes or callouts for any platform-specific behaviors or requirements.
GitHub Create pull request

Scan History

Date Scan ID Status Bias Status
2025-09-11 00:00 #108 completed ✅ Clean
2025-08-11 00:00 #77 completed ✅ Clean
2025-08-10 00:00 #76 completed ✅ Clean
2025-08-09 00:00 #75 completed ✅ Clean
2025-08-08 00:00 #74 completed ✅ Clean
2025-08-07 00:00 #73 completed ✅ Clean
2025-07-13 21:37 #48 completed ❌ Biased
2025-07-12 23:44 #41 in_progress ❌ Biased

Flagged Code Snippets

### View policy definitions with PowerShell To see all policy definitions in your subscription, use the following command:
The output is stored in a `$definition` object, which is used during policy assignment. The following example creates a policy definition that includes parameters:
#### Create a policy initiative definition with Azure PowerShell You can create a policy initiative definition using Azure PowerShell with the `New-AzPolicySetDefinition` cmdlet. To create a policy initiative definition with an existing policy definition, use the following policy initiative definition file as `VMPolicySet.json`: