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:
⚠️ powershell_heavy
⚠️ windows_first
⚠️ missing_linux_example
⚠️ windows_tools
Summary:
The documentation demonstrates a Windows bias in the section on retrieving the Azure Maps Client ID programmatically. PowerShell is presented first, with a detailed example using the Get-AzMapsAccount cmdlet, which is specific to Windows environments. The Azure CLI example is provided second, but there are no Linux- or macOS-specific shell examples (e.g., Bash, curl, jq), nor is there mention of cross-platform scripting approaches. The documentation also references Windows-centric tools and patterns (PowerShell) without providing parity for Linux users.
Recommendations:
  • Provide Bash (Linux/macOS) shell examples alongside PowerShell, using curl and jq to retrieve the Client ID via the Azure REST API or Azure CLI.
  • Present Azure CLI examples before or alongside PowerShell examples, as Azure CLI is cross-platform.
  • Explicitly state that both PowerShell and Azure CLI are available on all major platforms, and clarify any platform-specific requirements.
  • Avoid assuming the use of Windows tools (such as PowerShell) as the default or primary method.
  • Where possible, use cross-platform tools and patterns in code samples to ensure inclusivity for Linux and macOS users.
GitHub Create pull request

Scan History

Date Scan ID Status Bias Status
2025-08-17 00:01 #83 in_progress ✅ Clean
2025-07-13 21:37 #48 completed ✅ Clean
2025-07-09 13:09 #3 cancelled ✅ Clean
2025-07-08 04:23 #2 cancelled ❌ Biased

Flagged Code Snippets

> $maps = Get-AzMapsAccount -Name {Azure-Maps_Account-Name} -ResourceGroupName {Resource-Group-Name} -SubscriptionId {SubscriptionId} > $ClientId = $maps.UniqueId >
> $ClientId = az maps account show --name {Azure-Maps_Account-Name} --resource-group {Resource-Group-Name} --subscription {SubscriptionId} --query properties.uniqueId >