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
Summary:
The documentation demonstrates a Windows bias by centering the workflow around PowerShell (even for Linux/macOS clients), presenting Windows Remote Desktop instructions before Linux alternatives, and using Windows-centric tools and patterns throughout. Linux instructions are present but less detailed and positioned after Windows examples.
Recommendations:
- Provide equal prominence and detail for Linux workflows, including step-by-step instructions for using FreeRDP and other Linux-compatible RDP clients.
- Include example commands and outputs for Linux/macOS terminals, not just PowerShell.
- Clarify any differences or prerequisites for Linux/macOS users (e.g., how to install and use PowerShell 7 on Linux, or alternative ways to connect if PowerShell is not preferred).
- Present Windows and Linux/macOS instructions in parallel sections or side-by-side, rather than always listing Windows first.
- Mention and link to alternative Linux-native tools where applicable, and provide troubleshooting tips specific to non-Windows environments.
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>