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:
⚠️
windows_first
⚠️
missing_linux_example
⚠️
windows_tools
Summary:
The documentation demonstrates a Windows bias by exclusively providing examples for creating a Windows virtual machine, omitting Linux VM creation steps. Additionally, the PowerShell examples and references to Windows-specific tools are presented alongside Azure CLI, but there is no mention of Linux-specific considerations or examples. The Azure CLI installation link defaults to the Windows tab, and the VM creation uses a Windows image without offering a Linux alternative.
Recommendations:
- Add parallel examples for creating a Linux virtual machine (e.g., using --image UbuntuLTS in Azure CLI and the equivalent in PowerShell).
- Include a section or tab for Linux-specific instructions, such as SSH key setup and Linux admin username conventions.
- Ensure Azure CLI installation instructions are cross-platform, or at least link to Linux/macOS installation guides equally.
- When referencing PowerShell, clarify that it is available cross-platform, or provide Bash alternatives where appropriate.
- Use neutral language and ordering (e.g., 'Create a Windows or Linux virtual machine') to avoid implying Windows is the default or only supported OS.
Create pull request
Flagged Code Snippets
new-azResourceGroup -Name "test-rg" -Location "eastus"
az vm create `
--resource-group "test-rg" `
--name "testvm" `
--location "eastus" `
--image win2016datacenter `
--admin-username testUser `
--size Standard_D2s_v3 `
--storage-sku Standard_LRS
New-AzVm `
-ResourceGroupName 'test-rg' `
-Name 'testvm' `
-Location 'eastus' `
-VirtualNetworkName 'testvm-vnet' `
-SubnetName 'testvm-subnet' `
-SecurityGroupName 'test-vm-nsg'