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_tools
⚠️
windows_first
⚠️
missing_linux_example
Summary:
The documentation demonstrates a strong Windows and PowerShell bias. All scripting examples use PowerShell (.ps1) scripts, and the only script-based deployment method shown is via Azure PowerShell. The 'Copy and deploy' task examples use the 'windows-latest' agent pool, and there is no mention or example of using Bash, Linux agents, or cross-platform scripting. Windows tools and patterns (such as Visual Studio project scripts and PowerShell) are referenced exclusively or before any Linux alternatives, with no Linux/Unix shell or CLI equivalents provided.
Recommendations:
- Provide equivalent Bash or Azure CLI examples for deploying ARM templates, especially for users on Linux or macOS.
- Demonstrate the use of 'ubuntu-latest' or other Linux agent pools in the 'Copy and deploy' section, not just in the PowerShell example.
- Reference cross-platform tools (e.g., AzCopy, Azure CLI) and show how to use them in YAML pipelines, including sample scripts.
- Mention and link to documentation for running scripts on Linux/macOS agents, and clarify any differences or limitations.
- Balance references to Visual Studio and PowerShell with alternatives like VS Code and Bash/Azure CLI workflows.
Create pull request
Flagged Code Snippets
ScriptArguments: -Location 'centralus' -ResourceGroupName 'demogroup' -TemplateFile templates\mainTemplate.json
trigger:
- master
pool:
vmImage: 'windows-latest'
steps:
- task: AzureFileCopy@4
inputs:
SourcePath: 'templates'
azureSubscription: 'copy-connection'
Destination: 'AzureBlob'
storage: 'demostorage'
ContainerName: 'projecttemplates'
name: AzureFileCopy
trigger:
- master
pool:
vmImage: 'windows-latest'
steps:
- task: AzureFileCopy@4
inputs:
SourcePath: 'templates'
azureSubscription: 'copy-connection'
Destination: 'AzureBlob'
storage: 'demostorage'
ContainerName: 'projecttemplates'
name: AzureFileCopy
- task: AzureResourceManagerTemplateDeployment@3
inputs:
deploymentScope: 'Resource Group'
azureResourceManagerConnection: 'copy-connection'
subscriptionId: 'aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e'
action: 'Create Or Update Resource Group'
resourceGroupName: 'demogroup'
location: 'West US'
templateLocation: 'URL of the file'
csmFileLink: '$(AzureFileCopy.StorageContainerUri)templates/mainTemplate.json$(AzureFileCopy.StorageContainerSasToken)'
csmParametersFileLink: '$(AzureFileCopy.StorageContainerUri)templates/mainTemplate.parameters.json$(AzureFileCopy.StorageContainerSasToken)'
deploymentMode: 'Incremental'
deploymentName: 'deploy1'