This page contains Windows bias

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

Scan History

Date Scan ID Status Bias Status
2025-07-12 23:44 #41 in_progress ❌ Biased
2025-07-12 00:58 #8 cancelled ✅ Clean
2025-07-10 05:06 #7 processing ✅ Clean

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)