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_first
⚠️
windows_tools
⚠️
missing_linux_example
Summary:
The documentation provides examples for Azure CLI, PowerShell, and ARM templates, but there is a noticeable Windows bias. PowerShell (a Windows-centric tool) is given a dedicated section with detailed examples, and Windows terminology (such as 'adminPassword' in ARM templates) is present even in Linux examples. The ARM template section references both Linux and Windows, but the example shown is ambiguous and includes a Windows-style password. There are no explicit Linux shell (bash) or cloud-init examples, and Windows tools/patterns are mentioned at least as prominently as Linux equivalents.
Recommendations:
- Add explicit bash/shell scripting examples for Linux users, especially for common tasks such as creating scale sets or configuring network resources.
- In ARM template examples, clearly differentiate between Linux and Windows configurations (e.g., use SSH keys and omit 'adminPassword' for Linux).
- Ensure that Linux-first or cross-platform examples are presented before or alongside PowerShell/Windows-specific examples.
- Where PowerShell is shown, provide equivalent bash/CLI commands or scripts to ensure Linux parity.
- Clarify in each example whether it applies to Linux, Windows, or both, and provide OS-specific guidance where necessary.
- Include references to Linux-native configuration tools (e.g., cloud-init) where relevant.
Create pull request
Flagged Code Snippets
New-AzVmss `
-ResourceGroupName "myResourceGroup" `
-Location "EastUS2" `
-OrchestrationMode "Flexible" ``
-VMScaleSetName "myScaleSet" `
-VirtualNetworkName "myVnet" `
-SubnetName "mySubnet" `
-PublicIpAddressName "myPublicIPAddress" `
-LoadBalancerName "myLoadBalancer" `
-UpgradePolicy "Automatic" `
-Zone "1", "2", "3"
New-AzVmss `
-ResourceGroupName "myResourceGroup" `
-Location "EastUS2" `
-OrchestrationMode "flexible" ``
-VMScaleSetName "myScaleSet" `
-OrchestrationMode "Flexible" `
-VirtualNetworkName "myVnet" `
-SubnetName "mySubnet" `
-PublicIpAddressName "myPublicIPAddress" `
-LoadBalancerName "myLoadBalancer" `
-UpgradePolicy "Automatic" `
-Zone "1"