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