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
⚠️
missing_linux_example
⚠️
windows_tools
Summary:
The documentation demonstrates a strong Windows bias. All command-line examples for certificate creation and backend server setup use Windows PowerShell and Windows-specific tools (e.g., New-SelfSignedCertificate, Export-PfxCertificate, Add-WindowsFeature). The tutorial instructs users to create Windows Server VMs and install IIS using PowerShell, with no mention of Linux alternatives or how to perform equivalent steps on Linux systems. There are no Linux shell, OpenSSL, or Apache/Nginx examples, and Linux VMs are not discussed as backend options.
Recommendations:
- Provide equivalent Linux instructions for creating a self-signed certificate using OpenSSL, including export to PFX format.
- Include examples for deploying Linux VMs (e.g., Ubuntu) as backend servers, and show how to install a web server (e.g., Apache or Nginx) for testing.
- Show how to upload certificates generated on Linux to the Azure portal.
- Where PowerShell is used, offer Bash or CLI alternatives for Linux/macOS users.
- Explicitly state that both Windows and Linux VMs are supported as backends, and provide parity in setup instructions.
Create pull request
Flagged Code Snippets
New-SelfSignedCertificate `
-certstorelocation cert:\localmachine\my `
-dnsname www.contoso.com
PSParentPath: Microsoft.PowerShell.Security\Certificate::LocalMachine\my
Thumbprint Subject
---------- -------
E1E81C23B3AD33F9B4D1717B20AB65DBB91AC630 CN=www.contoso.com
$pwd = ConvertTo-SecureString -String <your password> -Force -AsPlainText
Export-PfxCertificate `
-cert cert:\localMachine\my\E1E81C23B3AD33F9B4D1717B20AB65DBB91AC630 `
-FilePath c:\appgwcert.pfx `
-Password $pwd