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 provides parallel examples for Azure CLI and Azure PowerShell throughout, but PowerShell is given equal prominence to the CLI, despite being primarily a Windows-centric tool. There are no explicit Linux shell (bash) or cross-platform scripting examples beyond the CLI, and PowerShell is referenced as a standard tool for automation and scripting. In some sections, PowerShell is mentioned before or alongside CLI, reinforcing its status as a primary automation tool, which may not reflect the experience of Linux users.
Recommendations:
- Clarify that Azure CLI commands are fully supported on Linux, macOS, and Windows, and consider providing bash-specific examples or notes for Linux users.
- Where PowerShell is referenced, note that Azure PowerShell is available cross-platform, but that bash/shell scripting is often preferred on Linux.
- Consider including bash script equivalents for multi-step CLI examples, especially where variables or pipelines are used.
- Avoid implying that PowerShell is the default or only scripting environment for automation; present CLI/bash as the primary cross-platform option.
- Explicitly mention Linux support and provide links to Linux installation and usage guides for both Azure CLI and PowerShell.
Create pull request
Flagged Code Snippets
# Create an IoT Central application with a managed identity
New-AzIotCentralApp -ResourceGroupName "MyIoTCentralResourceGroup" `
-Name "myiotcentralapp" -Subdomain "mysubdomain" `
-Sku "ST1" -Template "iotc-pnp-preview" `
-DisplayName "My Custom Display Name" -Identity "SystemAssigned"
# Enable a system-assigned managed identity
Set-AzIotCentralApp -ResourceGroupName "MyIoTCentralResourceGroup" `
-Name "myiotcentralapp" -Identity "SystemAssigned"
$resourceGroup = Get-AzResourceGroup -Name "MyIoTCentralResourceGroup"
$app = Get-AzIotCentralApp -ResourceGroupName $resourceGroup.ResourceGroupName -Name "myiotcentralapp"
$sp = Get-AzADServicePrincipal -ObjectId $app.Identity.PrincipalId
New-AzRoleAssignment -RoleDefinitionName "Azure Event Hubs Data Sender" `
-ObjectId $sp.Id -Scope $resourceGroup.ResourceId