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 page demonstrates a Windows bias by providing detailed PowerShell examples for generating and retrieving managed identities, referencing the Azure portal (which is often more familiar to Windows users), and omitting equivalent CLI (az CLI), Bash, or Linux-native examples. PowerShell is presented as the primary or only scripting interface, and there are no Linux/Unix shell or cross-platform command-line examples. This may disadvantage users working on Linux or macOS environments.
Recommendations:
  • Add equivalent Azure CLI (az) command examples for all PowerShell commands, as Azure CLI is cross-platform and widely used on Linux/macOS.
  • Explicitly mention that PowerShell commands can be run on any platform with PowerShell Core, or provide Bash alternatives where possible.
  • When listing methods (e.g., 'using PowerShell, REST API, SDK'), include Azure CLI as a first-class option.
  • For retrieving managed identities, provide az CLI commands (e.g., az datafactory show ...) alongside PowerShell.
  • Balance the order of presentation so that Windows-specific tools (PowerShell) are not always listed before cross-platform tools (CLI, REST, SDK).
  • Include notes or links for users on Linux/macOS about how to accomplish the same tasks in their environments.
GitHub Create pull request

Scan History

Date Scan ID Status Bias Status
2025-09-08 00:00 #105 completed ✅ Clean
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

PS C:\> Set-AzDataFactoryV2 -ResourceGroupName <resourceGroupName> -Name <dataFactoryName> -Location <region> DataFactoryName : ADFV2DemoFactory DataFactoryId : /subscriptions/<subsID>/resourceGroups/<resourceGroupName>/providers/Microsoft.DataFactory/factories/ADFV2DemoFactory ResourceGroupName : <resourceGroupName> Location : East US Tags : {} Identity : Microsoft.Azure.Management.DataFactory.Models.FactoryIdentity ProvisioningState : Succeeded
PS C:\> (Get-AzDataFactoryV2 -ResourceGroupName <resourceGroupName> -Name <dataFactoryName>).Identity PrincipalId TenantId ----------- -------- aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb aaaabbbb-0000-cccc-1111-dddd2222eeee
PS C:\> Get-AzADServicePrincipal -ObjectId aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb ServicePrincipalNames : {00001111-aaaa-2222-bbbb-3333cccc4444, https://identity.azure.net/P86P8g6nt1QxfPJx22om8MOooMf/Ag0Qf/nnREppHkU=} ApplicationId : 00001111-aaaa-2222-bbbb-3333cccc4444 DisplayName : ADFV2DemoFactory Id : aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb Type : ServicePrincipal