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 page exhibits 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, Set-AzVMExtension with Windows commands). The tutorial instructs users to create Windows Server VMs and install IIS, with no mention or example of Linux alternatives (such as using OpenSSL for certificates or deploying Linux VMs with Apache/Nginx). Linux tools and workflows are entirely absent, and Windows approaches are presented as the default and only method.
Recommendations:
- Provide equivalent Linux examples for creating self-signed certificates (e.g., using OpenSSL) and exporting PFX files.
- Include instructions for deploying Linux-based backend VMs (e.g., Ubuntu Server) and installing a web server such as Apache or Nginx.
- Show how to use Azure CLI or Bash in Cloud Shell for steps that are currently PowerShell-only.
- Mention both Windows and Linux options in all relevant sections, and avoid presenting Windows as the only or default platform.
- Add notes or links to cross-platform documentation where appropriate.
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
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