Quickstart Create 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.

View on GitHub 📚 View on Microsoft Learn

Bias Analysis

Detected Bias Types

windows_first

missing_linux_example

windows_tools

Summary

The documentation demonstrates a Windows bias by consistently using Windows-style file paths (e.g., C:\templates\main.bicep) in all examples, regardless of shell. There are no Linux/macOS path examples or notes for cross-platform users. Additionally, references to Visual Studio Code and PowerShell are prominent, and the only role-based access control tutorial linked is for PowerShell. While Azure CLI is included (which is cross-platform), the lack of Linux/macOS-specific guidance and the default to Windows conventions may confuse or exclude non-Windows users.

Recommendations

Provide both Windows (C:\path\to\file) and Linux/macOS (/home/user/path/to/file or ~/path/to/file) path examples in all command samples.
Add notes or tabs clarifying file path differences between platforms.
Include links to role-based access control tutorials for Azure CLI and/or portal, not just PowerShell.
Mention that Azure CLI and Bicep are cross-platform and provide installation/use guidance for Linux/macOS.
Where PowerShell is referenced, clarify that it is available on Linux/macOS, or provide Bash equivalents where appropriate.
Review all code snippets and instructions to ensure they are not Windows-centric by default.

Create Pull Request

Scan History

Date	Scan	Status	Result
2026-01-14 00:00	#250	in_progress	Biased
2026-01-13 00:00	#246	completed	Biased
2026-01-12 00:00	#243	cancelled	Biased
2026-01-11 00:00	#240	completed	Biased
2026-01-10 00:00	#237	completed	Biased
2026-01-09 00:34	#234	completed	Biased
2026-01-08 00:53	#231	completed	Biased
2026-01-06 18:15	#225	cancelled	Clean
2025-08-17 00:01	#83	cancelled	Clean
2025-07-13 21:37	#48	completed	Biased

Flagged Code Snippets

    New-AzResourceGroupDeployment `
      -TemplateSpecId $id `
      -ResourceGroupName storageRG `
      -storageAccountType Standard_GRS

   New-AzTemplateSpec `
     -Name storageSpec `
     -Version "2.0" `
     -ResourceGroupName templateSpecRG `
     -Location westus2 `
     -TemplateFile "C:\templates\main.bicep"

    New-AzResourceGroupDeployment `
      -ResourceGroupName storageRG `
      -TemplateFile "C:\templates\storage.bicep"

    New-AzResourceGroupDeployment `
      -ResourceGroupName templateSpecRG `
      -TemplateFile "C:\templates\main.bicep"

    New-AzResourceGroup `
      -Name storageRG `
      -Location westus2

    az deployment group create \
      --resource-group templateSpecRG \
      --template-file "C:\templates\main.bicep"

    New-AzResourceGroupDeployment `
      -ResourceGroupName storageRG `
      -TemplateFile "C:\templates\storage.bicep"

   (Get-AzContext).Subscription.Id

    New-AzResourceGroup `
      -Name storageRG `
      -Location westus2

    New-AzResourceGroupDeployment `
      -ResourceGroupName storageRG `
      -TemplateFile "C:\templates\storage.bicep"

   $id = (Get-AzTemplateSpec -ResourceGroupName templateSpecRG -Name storageSpec -Version "2.0").Versions.Id

Remove-AzResourceGroup -Name "templateSpecRG"

Remove-AzResourceGroup -Name "storageRG"

    New-AzResourceGroupDeployment `
      -ResourceGroupName templateSpecRG `
      -TemplateFile "C:\templates\main.bicep"

    New-AzTemplateSpec `
      -Name storageSpec `
      -Version "1.0" `
      -ResourceGroupName templateSpecRG `
      -Location westus2 `
      -TemplateFile "C:\templates\main.bicep"

    az ts create \
      --name storageSpec \
      --version "1.0" \
      --resource-group templateSpecRG \
      --location westus2 \
      --template-file "C:\templates\main.bicep"

    $id = (Get-AzTemplateSpec -ResourceGroupName templateSpecRG -Name storageSpec -Version "1.0").Versions.Id

    New-AzResourceGroupDeployment `
      -TemplateSpecId $id `
      -ResourceGroupName storageRG `
      -storageAccountType Standard_GRS

   $id = (Get-AzTemplateSpec -ResourceGroupName templateSpecRG -Name storageSpec -Version "2.0").Versions.Id

   az ts create \
     --name storageSpec \
     --version "2.0" \
     --resource-group templateSpecRG \
     --location westus2 \
     --template-file "C:\templates\main.bicep"

Remove-AzResourceGroup -Name "templateSpecRG"

Remove-AzResourceGroup -Name "storageRG"

Document Details

About This Page

Bias Analysis

Scan History

Flagged Code Snippets