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
⚠️
missing_linux_example
⚠️
windows_tools
⚠️
windows_first
Summary:
The documentation page demonstrates a Windows bias by providing only PowerShell command examples for certificate management, omitting equivalent Azure CLI (cross-platform) or Bash examples. The troubleshooting steps and automation guidance focus on PowerShell, which is traditionally associated with Windows environments. There is no mention of Linux or cross-platform workflows, and the use of PowerShell is presented as the default or only option for scripting and automation.
Recommendations:
- Add equivalent Azure CLI (az) command examples alongside PowerShell for all certificate management and troubleshooting tasks.
- Explicitly mention that Azure CLI commands can be run on Linux, macOS, and Windows, and provide Bash script examples where appropriate.
- Where PowerShell is referenced, clarify that it is available cross-platform, but also offer Bash/CLI alternatives to ensure Linux users are not excluded.
- Review all automation and scripting guidance to ensure parity between Windows and Linux tooling, and avoid presenting Windows tools as the default.
- Include a section or note highlighting cross-platform support and linking to relevant Azure CLI documentation.
Create pull request
Flagged Code Snippets
$appgw = Get-AzApplicationGateway -ResourceGroupName "<ResourceGroup>" -Name "<AppGatewayName>"
$password = ConvertTo-SecureString -String "<password>" -Force -AsPlainText
Set-AzApplicationGatewaySSLCertificate -Name "<oldcertname>" -ApplicationGateway $appgw -CertificateFile "<newcertPath>" -Password $password
Set-AzApplicationGateway -ApplicationGateway $appgw
$appgw = Get-AzApplicationGateway -ResourceGroupName "<ResourceGroup>" -Name "<AppGatewayName>"
$password = ConvertTo-SecureString -String "<password>" -Force -AsPlainText
Set-AzApplicationGatewaySSLCertificate -Name "<oldcertname>" -ApplicationGateway $appgw -CertificateFile "<newcertPath>" -Password $password
Set-AzApplicationGateway -ApplicationGateway $appgw
$appgw = Get-AzApplicationGateway -ResourceGroupName "<ResourceGroup>" -Name "<AppGatewayName>"
$secret = Get-AzKeyVaultSecret -VaultName "<KeyVaultName>" -Name "<CertificateName>"
$secretId = $secret.Id.Replace($secret.Version, "")
$cert = Set-AzApplicationGatewaySslCertificate -ApplicationGateway $AppGW -Name "<CertificateName>" -KeyVaultSecretId $secretId
Set-AzApplicationGateway -ApplicationGateway $appgw