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
⚠️
windows_tools
⚠️
missing_linux_example
Summary:
The documentation demonstrates a Windows bias by centering the workflow around PowerShell (with all commands and examples in PowerShell), presenting Windows Remote Desktop instructions before Linux (FreeRDP), and providing detailed steps and sample outputs only for Windows tools. Linux instructions are minimal and lack equivalent detail or troubleshooting guidance.
Recommendations:
- Provide equivalent command-line examples for Linux shells (e.g., bash) where possible, or clarify PowerShell usage on Linux with explicit instructions.
- Present Linux (FreeRDP) and macOS remote desktop instructions alongside Windows, not after, and with equal detail (e.g., how to create and use RDP files or command-line options).
- Include sample outputs for Linux/FreeRDP commands, not just for Windows/PowerShell.
- Add troubleshooting steps and credential guidance specific to Linux/macOS clients.
- Clarify any differences or prerequisites for using PowerShell on Linux/macOS, including installation and authentication nuances.
Create pull request
Flagged Code Snippets
Grant-HcsVMConnectAccess -ResourceGroupName <VM resource group> -VirtualMachineName <VM name>
[10.100.10.10]: PS>Grant-HcsVMConnectAccess -ResourceGroupName mywindowsvm1rg -VirtualMachineName mywindowsvm1
VirtualMachineId : 81462e0a-decb-4cd4-96e9-057094040063
VirtualMachineHostName : 3V78B03
ResourceGroupName : mywindowsvm1rg
VirtualMachineName : mywindowsvm1
Id : 81462e0a-decb-4cd4-96e9-057094040063
[10.100.10.10]: PS>
pcb:s:<VM ID from PowerShell>;EnhancedMode=0
full address:s:<IP address of the device>
server port:i:2179
username:s:EdgeARMUser
negotiate security layer:i:0
./wfreerdp /u:EdgeARMUser /vmconnect:<VM ID from PowerShell> /v:<IP address of the device>
Revoke-HcsVMConnectAccess -ResourceGroupName <VM resource group> -VirtualMachineName <VM name>
[10.100.10.10]: PS>Revoke-HcsVMConnectAccess -ResourceGroupName mywindowsvm1rg -VirtualMachineName mywindowsvm1
VirtualMachineId : 81462e0a-decb-4cd4-96e9-057094040063
VirtualMachineHostName : 3V78B03
ResourceGroupName : mywindowsvm1rg
VirtualMachineName : mywindowsvm1
Id : 81462e0a-decb-4cd4-96e9-057094040063
[10.100.10.10]: PS>