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
Summary:
The documentation demonstrates a Windows bias by providing detailed PowerShell examples and instructions before Azure CLI, emphasizing PowerShell/Windows tooling (e.g., Connect-AzAccount, Set-AzContext), and using Windows command syntax (e.g., REM, set) alongside Bash. While Azure CLI examples are present, the documentation often references Windows environments and tools first or exclusively, and the PowerShell section is more detailed and prominent.
Recommendations:
- Ensure equal depth and clarity for both PowerShell and Azure CLI sections, including troubleshooting and context.
- When presenting Azure CLI examples, consistently provide both Bash and Windows CMD syntax side-by-side, and clarify which is preferred for cross-platform use.
- Avoid using Windows-specific comments (e.g., REM) in CLI examples unless also providing the Bash equivalent (e.g., #).
- List Azure CLI and PowerShell options in parallel rather than always leading with PowerShell.
- Explicitly mention Linux/macOS compatibility and provide guidance for those environments where relevant.
- Where possible, use cross-platform terminology (e.g., 'terminal' instead of 'command prompt').
Create pull request
Flagged Code Snippets
$sub = Get-AzSubscription -ErrorAction SilentlyContinue
if(-not($sub))
{
Connect-AzAccount
}
# Set-AzContext -SubscriptionId "<Subscription ID>"
$devTestLabName = "<lab name>"
$vMToStart = "<VM name>"
$vmAction = "<Start or Stop>"
# Get the lab information
$devTestLab = Get-AzResource -ResourceType 'Microsoft.DevTestLab/labs' -ResourceName $devTestLabName
# Start or stop the VM and return a succeeded or failed status
$returnStatus = Invoke-AzResourceAction `
-ResourceId "$($devTestLab.ResourceId)/virtualmachines/$vMToStart" `
-Action $vmAction `
-Force
if ($returnStatus.Status -eq 'Succeeded') {
Write-Output "##[section] Successfully updated DTL machine: $vMToStart, Action: $vmAction"
}
else {
Write-Error "##[error] Failed to update DTL machine: $vMToStart, Action: $vmAction"
}
az login
REM az account set --subscription <SubscriptionId>
set SUBSCRIPTIONID=<SubscriptionId>
set RESOURCEGROUP=<resourceGroup>
set DEVTESTLABNAME=<lab name>
set VMNAME=<VM name>
set ACTION=<Start or Stop>