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
⚠️
windows_tools
Summary:
The documentation demonstrates a Windows bias by presenting PowerShell examples and instructions before CLI (Bash) or REST alternatives. The PowerShell section is more detailed, and the use of PowerShell-specific cmdlets and variable syntax is emphasized. There is no mention of Linux-specific shell environments or tools, and the CLI examples, while present, are secondary. The documentation assumes familiarity with PowerShell and Windows-centric tools, which may disadvantage Linux users.
Recommendations:
- Present CLI (Bash) examples before or alongside PowerShell examples, or alternate their order to avoid always prioritizing Windows tools.
- Expand CLI (Bash) sections to match the level of detail and explanation given in PowerShell sections.
- Explicitly mention that Azure CLI commands work cross-platform (Windows, Linux, macOS) and provide guidance for Linux users where appropriate.
- Include notes or links for installing and using Azure CLI and PowerShell on Linux, highlighting cross-platform compatibility.
- Where possible, provide examples using native Linux tools or scripting (e.g., Bash scripts) for automation scenarios.
- Avoid assuming PowerShell as the default automation tool; clarify that both PowerShell and CLI are equally supported.
Create pull request
Flagged Code Snippets
$apiManagementName="myapim";
$apiManagementResourceGroup="apimresourcegroup";
$storageAccountName="backupstorageaccount";
$storageResourceGroup="storageresourcegroup";
$containerName="backups";
$blobName="ContosoBackup.apimbackup"
$storageKey = (Get-AzStorageAccountKey -ResourceGroupName $storageResourceGroup -StorageAccountName $storageAccountName)[0].Value
$storageContext = New-AzStorageContext -StorageAccountName $storageAccountName -StorageAccountKey $storageKey
Backup-AzApiManagement -ResourceGroupName $apiManagementResourceGroup -Name $apiManagementName `
-StorageContext $storageContext -TargetContainerName $containerName -TargetBlobName $blobName
$storageContext = New-AzStorageContext -StorageAccountName $storageAccountName
Backup-AzApiManagement -ResourceGroupName $apiManagementResourceGroup -Name $apiManagementName `
-StorageContext $storageContext -TargetContainerName $containerName `
-TargetBlobName $blobName -AccessType "SystemAssignedManagedIdentity"
$identityName = "myidentity";
$identityResourceGroup = "identityresourcegroup";
$identityId = (Get-AzUserAssignedIdentity -Name $identityName -ResourceGroupName $identityResourceGroup).ClientId
$storageContext = New-AzStorageContext -StorageAccountName $storageAccountName
Backup-AzApiManagement -ResourceGroupName $apiManagementResourceGroup -Name $apiManagementName `
-StorageContext $storageContext -TargetContainerName $containerName `
-TargetBlobName $blobName -AccessType "UserAssignedManagedIdentity" ` -identityClientId $identityid