Template Specs - Document Details

About This Page

This page is part of the Azure documentation. It contains code examples and configuration instructions for working with Azure services.

View on GitHub 📚 View on Microsoft Learn

Bias Analysis

Detected Bias Types

windows_first

powershell_heavy

windows_tools

Summary

The documentation consistently presents Azure PowerShell (a Windows-centric tool) examples before Azure CLI, and in some sections, PowerShell is mentioned as a primary integration point (e.g., 'integrate the template spec into an existing deployment process such as a PowerShell script'). There is a general assumption of PowerShell usage, and no explicit mention of Linux shell or scripting environments. While Azure CLI is cross-platform, the documentation does not provide any Linux- or Bash-specific context or examples, nor does it mention Linux-native tools or scripting patterns. There are no examples or guidance tailored to Linux users, and PowerShell is sometimes referenced as the default automation tool.

Recommendations

Alternate the order of PowerShell and Azure CLI examples or present Azure CLI first, as it is cross-platform and more familiar to Linux users.
Explicitly mention that Azure CLI commands work in Bash, zsh, and other Linux shells, and provide example shell commands (e.g., export variables, use of $() for command substitution).
Where scripting or automation is discussed, include references to Bash scripts or Linux automation pipelines alongside PowerShell.
Avoid language that assumes PowerShell as the default scripting tool; instead, refer to 'automation scripts' or 'shell scripts' generically.
Add a short section or note highlighting Linux compatibility and any Linux-specific considerations for template specs.
If possible, provide at least one end-to-end example using Bash scripting to create, deploy, and manage template specs.

Create Pull Request

Scan History

Date	Scan	Status	Result
2025-07-12 23:44	#41	cancelled	Biased
2025-07-12 00:58	#8	cancelled	Clean
2025-07-10 05:06	#7	processing	Clean

Flagged Code Snippets

Get-AzTemplateSpec

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

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-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"}