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.

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.
GitHub Create pull request

Scan History

Date Scan ID Status Bias Status
2025-09-16 00:00 #113 completed ✅ Clean
2025-09-15 00:00 #112 completed ✅ Clean
2025-09-14 00:00 #111 completed ✅ Clean
2025-09-13 00:00 #110 completed ✅ Clean
2025-09-12 00:00 #109 completed ✅ Clean
2025-08-17 00:01 #83 in_progress ✅ Clean
2025-07-13 21:37 #48 completed ✅ Clean
2025-07-12 23:44 #41 in_progress ❌ Biased

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"