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
⚠️
powershell_heavy
Summary:
The documentation provides both Azure CLI and Azure PowerShell examples for all deployment and management steps, but consistently lists PowerShell examples immediately after CLI, and uses PowerShell-specific syntax and variable handling. There is no explicit mention of Linux or macOS environments, nor any guidance for shell differences (e.g., Bash vs PowerShell variable syntax). While Azure CLI is cross-platform, the documentation assumes familiarity with PowerShell and Windows conventions, which may disadvantage Linux users.
Recommendations:
- Explicitly state that Azure CLI commands work on Linux, macOS, and Windows, and provide Bash-specific variable assignment examples alongside PowerShell.
- For each example, include both Bash (for Linux/macOS) and PowerShell (for Windows) variable assignment and usage, e.g., show 'myContactEmails=("user1@contoso.com" "user2@contoso.com")' for Bash.
- Add a note clarifying that PowerShell examples are for Windows users, and Bash examples are for Linux/macOS users.
- Where referencing tools to retrieve resource IDs (e.g., 'az monitor action-group show' and 'Get-AzActionGroup'), ensure CLI (cross-platform) is mentioned first or equally, and provide example outputs for both.
- Consider adding a 'Platform differences' section to highlight any nuances or issues Linux/macOS users might encounter, such as quoting, variable expansion, or file path differences.
Create pull request
Flagged Code Snippets
myContactEmails ='("user1@contoso.com", "user2@contoso.com")'
az deployment sub create --name demoSubDeployment --location centralus --template-file main.bicep --parameters startDate=<start-date> endDate=<end-date> contactEmails=$myContactEmails
$myContactEmails = @("user1@contoso.com", "user2@contoso.com")
$myRgFilterValues = @("resource-group-01", "resource-group-02")
New-AzSubscriptionDeployment -Name demoSubDeployment -Location centralus -TemplateFile ./main.bicep -startDate "<start-date>" -endDate "<end-date>" -contactEmails $myContactEmails -resourceGroupFilterValues $myRgFilterValues
# [PowerShell](#tab/PowerShell)
$myContactEmails = @("user1@contoso.com", "user2@contoso.com")
New-AzSubscriptionDeployment -Name demoSubDeployment -Location centralus -TemplateFile ./main.bicep -startDate "<start-date>" -endDate "<end-date>" -contactEmails $myContactEmails
myContactEmails ='("user1@contoso.com", "user2@contoso.com")'
myRgFilterValues ='("resource-group-01", "resource-group-02")'
az deployment sub create --name demoSubDeployment --location centralus --template-file main.bicep --parameters startDate=<start-date> endDate=<end-date> contactEmails=$myContactEmails resourceGroupFilterValues=$myRgFilterValues
$myContactEmails = @("user1@contoso.com", "user2@contoso.com")
$myContactGroups = @("/subscriptions/{sub-id}/resourceGroups/{rg-name}/providers/microsoft.insights/actionGroups/groupone", "/subscriptions/{sub-id}/resourceGroups/{rg-name}/providers/microsoft.insights/actionGroups/grouptwo")
$myRgFilterValues = @("resource-group-01", "resource-group-02")
$myMeterCategoryFilterValues = @("meter-category-01", "meter-category-02")
New-AzSubscriptionDeployment -Name demoSubDeployment -Location centralus -TemplateFile ./main.bicep -startDate "<start-date>" -endDate "<end-date>" -contactEmails $myContactEmails -contactGroups $myContactGroups -resourceGroupFilterValues $myRgFilterValues -meterCategoryFilterValues $myMeterCategoryFilterValues
# [PowerShell](#tab/PowerShell)