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