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
Summary:
The documentation provides both PowerShell and Azure CLI examples for all command-line operations, which is positive for cross-platform parity. However, PowerShell examples are consistently presented first, and the narrative often refers to 'PowerShell or CLI' (rather than 'CLI or PowerShell'), subtly prioritizing Windows-centric tooling. There are no explicit Linux-only examples or references to Linux-specific workflows, shells, or file system conventions. No Windows-only tools are used, but the ordering and language suggest a mild Windows/PowerShell bias.
Recommendations:
- Alternate the order of PowerShell and CLI examples throughout the documentation, or present CLI examples first in some sections to avoid implicit prioritization.
- Use more neutral phrasing such as 'Azure CLI or PowerShell' instead of always 'PowerShell or CLI'.
- Explicitly mention that Azure CLI commands work cross-platform (Windows, Linux, macOS) and consider adding a note or example showing CLI usage in a Linux shell (e.g., bash).
- Where file paths are shown (e.g., './mainTemplate.json'), clarify that the syntax is compatible with both Windows and Linux/macOS, or provide both styles if relevant.
- Consider including a brief section or note on cross-platform compatibility, especially for users on Linux or macOS.
Create pull request
Flagged Code Snippets
New-AzTemplateSpec -Name storageSpec -Version 1.0a -ResourceGroupName templateSpecsRg -Location westus2 -TemplateFile ./mainTemplate.json
Get-AzTemplateSpec -ResourceGroupName templateSpecsRG -Name storageSpec
$id = "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/templateSpecsRG/providers/Microsoft.Resources/templateSpecs/storageSpec/versions/1.0a"
New-AzResourceGroupDeployment `
-TemplateSpecId $id `
-ResourceGroupName demoRG
$id = (Get-AzTemplateSpec -Name storageSpec -ResourceGroupName templateSpecsRg -Version 1.0a).Versions.Id
New-AzResourceGroupDeployment `
-ResourceGroupName demoRG `
-TemplateSpecId $id
New-AzResourceGroupDeployment `
-TemplateSpecId $id `
-ResourceGroupName demoRG `
-TemplateParameterFile ./mainTemplate.parameters.json
New-AzResourceGroupDeployment `
-TemplateSpecId $id `
-ResourceGroupName demoRG `
-StorageAccountType Standard_GRS
New-AzTemplateSpec `
-Name storageSpec `
-Version 1.0a `
-ResourceGroupName templateSpecsRg `
-Location westus2 `
-TemplateFile ./mainTemplate.json `
-Tag @{Dept="Finance";Environment="Production"}
Set-AzTemplateSpec `
-Name storageSpec `
-Version 1.0a `
-ResourceGroupName templateSpecsRg `
-Location westus2 `
-TemplateFile ./mainTemplate.json `
-Tag @{Dept="Finance";Environment="Production"}