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_tools
⚠️ windows_first
⚠️ missing_linux_example
Summary:
The documentation exhibits a Windows bias in several ways: all command-line examples (including for Linux VMs) use PowerShell and Azure PowerShell cmdlets, with no native Bash/CLI equivalents provided for Linux users. The sample outputs and instructions are shown from a Windows environment (e.g., PS C:\WINDOWS\system32>), even when managing Linux VMs. Windows-specific tools and paths are referenced first and more thoroughly. There is a lack of Linux-native command-line or scripting examples, and the removal command is only shown in PowerShell.
Recommendations:
  • Provide Azure CLI (az) command examples alongside or instead of Azure PowerShell cmdlets, especially for Linux VM scenarios.
  • Show Linux-native shell (Bash) commands and sample outputs for Linux users, including connecting to VMs, deploying templates, and removing extensions.
  • Balance the order of presentation: do not always present Windows first; alternate or present both OSes in parallel.
  • Include Linux-specific troubleshooting and log file locations in parity with Windows.
  • Clarify when commands are cross-platform (e.g., Azure CLI) and when they are Windows-only (e.g., PowerShell), and guide users to install necessary tools on their platform.
GitHub Create pull request

Scan History

Date Scan ID Status Bias Status
2025-08-17 00:01 #83 in_progress ✅ Clean
2025-07-13 21:37 #48 completed ❌ Biased
2025-07-09 13:09 #3 cancelled ✅ Clean
2025-07-08 04:23 #2 cancelled ❌ Biased

Flagged Code Snippets

$templateFile = "Path to addGPUextensiontoVM.json" $templateParameterFile = "Path to addGPUExtLinuxVM.parameters.json" $RGName = "<Name of your resource group>" New-AzureRmResourceGroupDeployment -ResourceGroupName $RGName -TemplateFile $templateFile -TemplateParameterFile $templateParameterFile -Name "<Name for your deployment>"
Get-AzureRmVMExtension -ResourceGroupName myResourceGroup -VMName <VM Name> -Name <Extension Name>
PS C:\WINDOWS\system32> "C:\12-09-2020\ExtensionTemplates\addGPUextensiontoVM.json" C:\12-09-2020\ExtensionTemplates\addGPUextensiontoVM.json PS C:\WINDOWS\system32> $templateFile = "C:\12-09-2020\ExtensionTemplates\addGPUextensiontoVM.json" PS C:\WINDOWS\system32> $templateParameterFile = "C:\12-09-2020\ExtensionTemplates\addGPUExtWindowsVM.parameters.json" PS C:\WINDOWS\system32> $RGName = "myasegpuvm1" PS C:\WINDOWS\system32> New-AzureRmResourceGroupDeployment -ResourceGroupName $RGName -TemplateFile $templateFile -TemplateParameterFile $templateParameterFile -Name "deployment3" DeploymentName : deployment3 ResourceGroupName : myasegpuvm1 ProvisioningState : Succeeded Timestamp : 12/16/2020 12:18:50 AM Mode : Incremental TemplateLink : Parameters : Name Type Value =============== ========================= ========== vmName String VM2 extensionName String windowsgpuext publisher String Microsoft.HpcCompute type String NvidiaGpuDriverWindows typeHandlerVersion String 1.3 settings Object { "DriverURL": "http://us.download.nvidia.com/tesla/442.50/442.50-tesla-desktop-winserver-2019-2016-international.exe", "DriverCertificateUrl": "https://go.microsoft.com/fwlink/?linkid=871664", "DriverType": "CUDA" } Outputs : DeploymentDebugLogLevel : PS C:\WINDOWS\system32>
Copyright (C) Microsoft Corporation. All rights reserved. Try the new cross-platform PowerShell https://aka.ms/pscore6 PS C:\WINDOWS\system32> $templateFile = "C:\12-09-2020\ExtensionTemplates\addGPUextensiontoVM.json" PS C:\WINDOWS\system32> $templateParameterFile = "C:\12-09-2020\ExtensionTemplates\addGPUExtLinuxVM.parameters.json" PS C:\WINDOWS\system32> $RGName = "rg2" PS C:\WINDOWS\system32> New-AzureRmResourceGroupDeployment -ResourceGroupName $RGName -TemplateFile $templateFile -TemplateParameterFile $templateParameterFile -Name "deployment7" DeploymentName : deployment7 ResourceGroupName : rg2 ProvisioningState : Succeeded Timestamp : 12/10/2020 10:43:23 PM Mode : Incremental TemplateLink : Parameters : Name Type Value =============== ========================= ========== vmName String VM1 extensionName String gpuLinux publisher String Microsoft.HpcCompute type String NvidiaGpuDriverLinux typeHandlerVersion String 1.3 settings Object { "DRIVER_URL": "https://go.microsoft.com/fwlink/?linkid=874271", "PUBKEY_URL": "http://download.microsoft.com/download/F/F/A/FFAC979D-AD9C-4684-A6CE-C92BB9372A3B/7fa2af80.pub", "CUDA_ver": "10.0.130", "InstallCUDA": "true" } Outputs : DeploymentDebugLogLevel : PS C:\WINDOWS\system32>