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.
Create pull request
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`: