Template Specs Create Linked - 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

missing_linux_example

Summary

The documentation exhibits a Windows bias by using Windows-style file paths (e.g., c:\Templates\...), referencing PowerShell and Azure CLI as the only scripting environments, and providing Windows-specific notes (such as known issues with Windows PowerShell). Linux or macOS-specific instructions, file path examples, or shell scripting examples are missing, and Windows conventions are presented first throughout.

Recommendations

Provide Linux/macOS file path examples alongside Windows paths (e.g., /home/user/Templates/linkedTS/azuredeploy.json).
Include bash shell variable assignment examples for Azure CLI commands (e.g., id=$(az ts show ...)).
Add notes about cross-platform compatibility for both PowerShell Core (pwsh) and Windows PowerShell, clarifying differences if any.
Explicitly mention that the Azure CLI and PowerShell examples work on Linux/macOS, and provide any necessary adjustments (such as path separators or environment-specific issues).
If referencing known issues, specify if they are Windows-only and note if Linux/macOS are unaffected.
Consider adding a table or section summarizing differences or tips for Linux/macOS users.

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

New-AzResourceGroup `
  -Name templateSpecRG `
  -Location westus2

New-AzTemplateSpec `
  -Name webSpec `
  -Version "1.0.0.0" `
  -ResourceGroupName templateSpecRG `
  -Location westus2 `
  -TemplateFile "c:\Templates\linkedTS\azuredeploy.json"

---

## Deploy template spec

You can now deploy the template spec. Deploying the template spec is just like deploying the template it contains, except that you pass in the resource ID of the template spec. You use the same deployment commands, and if needed, pass in parameter values for the template spec.

# [PowerShell](#tab/azure-powershell)