Document Details

Template Specs
Home / Scan 48 / Template Specs
❌
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.
GitHub View on GitHub 📚 View on Microsoft Learn

Bias Analysis

Bias Types:
⚠️ windows_first
⚠️ powershell_heavy
⚠️ windows_tools
Summary:
The documentation consistently presents Azure PowerShell (a Windows-centric tool) examples before Azure CLI, and frequently references PowerShell scripts and usage patterns. There is no mention of Linux-specific tools, shells, or workflows, and the examples assume familiarity with PowerShell syntax and conventions. While Azure CLI is cross-platform, the documentation's ordering and emphasis on PowerShell may give the impression of a Windows-first or Windows-preferred environment.
Recommendations:
  • Alternate the order of PowerShell and Azure CLI examples, or present Azure CLI examples first to reflect its cross-platform nature.
  • Explicitly mention that Azure CLI commands work on Linux, macOS, and Windows, and provide example shell commands (e.g., bash) where appropriate.
  • Avoid language that implies PowerShell is the default or preferred tool; clarify that both PowerShell and CLI are supported equally.
  • Where scripting is discussed, provide both PowerShell and bash (or sh) script snippets to illustrate parity.
  • If referencing scripts or automation, mention both PowerShell scripts and shell scripts (bash/sh) as valid approaches.
  • Consider adding a brief section or note for Linux/macOS users highlighting any differences or confirming full support.
GitHub 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 ❌ Biased

Flagged Code Snippets

New-AzResourceGroupDeployment ` -TemplateSpecId $id ` -ResourceGroupName demoRG ` -StorageAccountType Standard_GRS
New-AzResourceGroupDeployment ` -TemplateSpecId $id ` -ResourceGroupName demoRG ` -TemplateParameterFile ./mainTemplate.parameters.json
New-AzTemplateSpec ` -Name storageSpec ` -Version 1.0a ` -ResourceGroupName templateSpecsRg ` -Location westus2 ` -TemplateFile ./mainTemplate.bicep ` -Tag @{Dept="Finance";Environment="Production"}
Set-AzTemplateSpec ` -Name storageSpec ` -Version 1.0a ` -ResourceGroupName templateSpecsRg ` -Location westus2 ` -TemplateFile ./mainTemplate.bicep ` -Tag @{Dept="Finance";Environment="Production"}
$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
Get-AzTemplateSpec
Get-AzTemplateSpec -ResourceGroupName templateSpecsRG -Name storageSpec