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_tools
⚠️
missing_linux_example
⚠️
windows_first
Summary:
The documentation demonstrates a strong Windows bias. All examples and scripts are provided in PowerShell, with no mention of Linux or cross-platform alternatives. The tooling and patterns referenced (e.g., IIS, RDGatewayFedAuth.msi, System Center VMM, RDP file workflow) are Windows-centric. There is no guidance for Linux-based remote desktop solutions or how to connect from Linux clients. The documentation assumes the use of Windows infrastructure and tools throughout.
Recommendations:
- Provide equivalent instructions and scripts for Linux environments, such as using OpenSSL for certificate creation and Bash/Azure CLI for automation.
- Include examples of connecting to lab VMs using open-source RDP clients available on Linux (e.g., xfreerdp, Remmina), and clarify token authentication compatibility.
- Mention and, where possible, support Linux-based gateway solutions (such as xrdp or guacd) or clarify if only Windows gateways are supported.
- When listing tools or scripts, present cross-platform or Linux options alongside Windows/PowerShell examples, not just after them.
- Explicitly state any limitations or lack of support for Linux clients or servers, so users can plan accordingly.
- Reference Azure Bastion as a cross-platform alternative more prominently, and provide a comparison table for remote access options across OSes.
Create pull request
Flagged Code Snippets
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{labName}/virtualmachines/{name}/getRdpFileContents
$cer = New-Object System.Security.Cryptography.X509Certificates.X509Certificate;
$cer.Import('path-to-certificate');
$hash = $cer.GetCertHashString()
[System.Convert]::ToBase64String([System.IO.File]::ReadAllBytes('path-to-certificate'))