Manage Secrets - Document Details

About This Page

This page is part of the Azure documentation. It contains code examples and configuration instructions for working with Azure services.

View on GitHub 📚 View on Microsoft Learn

Bias Analysis

Detected 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.

Create Pull Request

Scan History

Date	Scan	Status	Result
2026-01-14 00:00	#250	in_progress	Biased
2026-01-13 00:00	#246	completed	Biased
2026-01-11 00:00	#240	completed	Biased
2026-01-10 00:00	#237	completed	Biased
2026-01-09 00:34	#234	completed	Biased
2026-01-08 00:53	#231	completed	Biased
2026-01-06 18:15	#225	cancelled	Clean
2025-09-12 00:00	#109	completed	Clean
2025-08-17 00:01	#83	cancelled	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