Document Details

Configure Customer Managed Keys
Home / Scan #48 / Configure Customer Managed Keys
Sad Tux - Windows bias detected
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.
GitHub View on GitHub 📚 View on Microsoft Learn

Bias Analysis

Detected Bias Types
windows_first
powershell_heavy
windows_tools
missing_linux_example
Summary
The documentation demonstrates a Windows bias by consistently presenting Azure Portal (GUI) and Azure PowerShell instructions before Azure CLI examples. PowerShell is a Windows-centric tool, and its inclusion as a primary method, alongside the absence of explicit Linux shell examples (e.g., Bash), reinforces this bias. There are no Linux-specific command-line examples or troubleshooting steps, and the documentation does not mention or address Linux environments or tools directly. The use of screenshots and instructions is focused on the Azure Portal, which is OS-agnostic but often associated with Windows workflows. No mention is made of Linux-native scripting, automation, or integration patterns.
Recommendations
  • Present Azure CLI (which is cross-platform and preferred on Linux) examples before PowerShell examples, or at least give them equal prominence.
  • Explicitly mention that Azure CLI commands are suitable for Linux, macOS, and Windows, and provide Bash-specific usage notes where relevant.
  • Add troubleshooting and scripting examples that use Bash shell idioms (e.g., environment variables, piping, jq for JSON parsing) to illustrate Linux-native workflows.
  • Where PowerShell is shown, provide equivalent Bash scripts or shell commands for common automation scenarios.
  • Clarify in the introduction or requirements that all command-line instructions are cross-platform unless otherwise noted, and highlight any OS-specific caveats.
  • Include references or links to Linux-specific Azure CLI installation and usage guides.
GitHub Create Pull Request

Scan History

Date Scan Status Result
2026-01-12 00:00 #99 completed Biased Biased
2026-01-11 06:20 #98 completed Biased Biased
2026-01-10 00:00 #92 completed Clean Clean
2026-01-09 00:00 #87 cancelled Clean Clean
2026-01-06 22:28 #78 completed Clean Clean
2025-12-29 18:00 #48 cancelled Biased Biased
2025-12-15 00:00 #7 completed Clean Clean
2025-12-14 05:05 #6 completed Clean Clean

Flagged Code Snippets

    $netappAccount = Update-AzNetAppFilesAccount -ResourceGroupName <resource_group> -Name <account_name> -AssignIdentity
    
    Set-AzKeyVaultAccessPolicy -VaultName <key_vault_name> -ResourceGroupname <resource_group> -ObjectId $netappAccount.Identity.PrincipalId -PermissionsToKeys get,encrypt,decrypt
    
    Update-AzNetAppFilesAccount -ResourceGroupName $netappAccount.ResourceGroupName -AccountName $netappAccount.Name -KeyVaultEncryption -KeyVaultUri <keyVaultUri> -KeyName <keyName>
    
    $userId = New-AzUserAssignedIdentity -ResourceGroupName <resourceGroupName> -Name $userIdName
    
    Set-AzKeyVaultAccessPolicy -VaultName <key_vault_name> `
        -ResourceGroupname <resource_group> `
        -ObjectId $userId.PrincipalId `
        -PermissionsToKeys get,encrypt,decrypt `
        -BypassObjectIdValidation
    
    $netappAccount = Update-AzNetAppFilesAccount -ResourceGroupName <resource_group> `
        -Name <account_name> `
        -IdentityType UserAssigned `
        -UserAssignedIdentityId $userId.Id `
        -KeyVaultEncryption `
        -KeyVaultUri <keyVaultUri> `
        -KeyName <keyName> `
        -EncryptionUserAssignedIdentity $userId.Id