Document Details

Manage Secrets
Home / Scan 2 / Manage Secrets
❌
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

Bias Types:
⚠️ powershell_heavy
⚠️ windows_first
⚠️ windows_tools
⚠️ missing_linux_example
Summary:
The documentation demonstrates a bias toward Windows and PowerShell by consistently providing PowerShell examples alongside Azure CLI, ARM, and portal instructions, even when PowerShell support is incomplete or missing for certain features (e.g., Key Vault references, secret volume mounts). There is no mention or example of Linux-specific tools, shell scripting, or cross-platform command-line usage (e.g., Bash), and PowerShell is presented as a primary automation method. The documentation does not address or acknowledge Linux shell environments, nor does it provide parity for Linux users in terms of scripting or automation guidance.
Recommendations:
  • Add explicit Bash/Linux shell examples for all CLI instructions, demonstrating usage in a typical Linux terminal environment.
  • Clarify that Azure CLI commands are cross-platform and can be run in Bash, PowerShell, or other shells, and provide sample commands for both Bash and PowerShell where relevant.
  • When PowerShell support is missing for a feature (e.g., Key Vault references, secret volume mounts), provide alternative Linux scripting or CLI-based workflows.
  • Avoid presenting PowerShell as the default or primary scripting language; instead, offer both PowerShell and Bash examples, or clearly indicate when an example is Windows-specific.
  • Include notes or sections addressing Linux/macOS users, such as environment variable syntax differences, file path conventions, and shell scripting best practices.
  • Where possible, provide downloadable sample scripts for both PowerShell and Bash to ensure parity and accessibility for users on all platforms.
GitHub Create pull request

Scan History

Date Scan ID Status Bias Status
2025-09-12 00:00 #109 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

$EnvId = (Get-AzContainerAppManagedEnv -ResourceGroupName my-resource-group -EnvName my-environment-name).Id $TemplateObj = New-AzContainerAppTemplateObject -Name queuereader -Image demos/queuereader:v1 $SecretObj = New-AzContainerAppSecretObject -Name queue-connection-string -Value $QueueConnectionString $ContainerAppArgs = @{ Name = 'my-resource-group' Location = '<location>' ResourceGroupName = 'my-resource-group' ManagedEnvironmentId = $EnvId TemplateContainer = $TemplateObj ConfigurationSecret = $SecretObj } New-AzContainerApp @ContainerAppArgs
$EnvId = (Get-AzContainerAppManagedEnv -ResourceGroupName my-resource-group -EnvName my-environment-name).Id $SecretObj = New-AzContainerAppSecretObject -Name queue-connection-string -Value $QueueConnectionString $EnvVarObjQueue = New-AzContainerAppEnvironmentVarObject -Name QueueName -Value myqueue $EnvVarObjConn = New-AzContainerAppEnvironmentVarObject -Name ConnectionString -SecretRef queue-connection-string -Value secretref $TemplateObj = New-AzContainerAppTemplateObject -Name myQueueApp -Image demos/myQueueApp:v1 -Env $EnvVarObjQueue, $EnvVarObjConn $ContainerAppArgs = @{ Name = 'myQueueApp' Location = '<location>' ResourceGroupName = 'my-resource-group' ManagedEnvironmentId = $EnvId TemplateContainer = $TemplateObj ConfigurationSecret = $SecretObj } New-AzContainerApp @ContainerAppArgs