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 page demonstrates a strong Windows bias. All command-line instructions for managing the Remote Desktop extension use PowerShell and the Az.CloudService module, which are Windows-centric tools. There are no examples or guidance for performing equivalent tasks using cross-platform tools such as Azure CLI, Bash, or Linux-native RDP clients. The workflow assumes the use of .rdp files and the Windows Remote Desktop client, with no mention of Linux or macOS alternatives. The 'Next steps' section also lists PowerShell and Visual Studio (both Windows-focused) before mentioning templates, and does not reference Azure CLI or Linux tools.
Recommendations:
- Add equivalent Azure CLI examples for managing the Remote Desktop extension, as Azure CLI is cross-platform and widely used on Linux and macOS.
- Include instructions or references for connecting to RDP-enabled instances from Linux and macOS, such as using 'xfreerdp', 'remmina', or 'rdesktop'.
- When listing deployment options, mention cross-platform tools (e.g., Azure CLI, ARM templates) before or alongside Windows-specific tools like PowerShell and Visual Studio.
- Clarify that .rdp files can be used with RDP clients on Linux and macOS, and provide links to relevant documentation.
- Where possible, use neutral language and tool-agnostic instructions, or provide parallel examples for both Windows and Linux/macOS users.
Create pull request
Flagged Code Snippets
Update-Module -Name Az.CloudService
$resourceGroupName='<Resource Group Name>'
$cloudServiceName='<Cloud Service Name>'
# Get existing cloud service
$cloudService = Get-AzCloudService -ResourceGroup $resourceGroupName -CloudServiceName $cloudServiceName
# Remove existing RDP Extension from cloud service object
$cloudService.ExtensionProfile.Extension = $cloudService.ExtensionProfile.Extension | Where-Object { $_.Type-ne "RDP" }
# Create new RDP extension object
$credential = Get-Credential
$expiration='<Expiration Date>'
$rdpExtension = New-AzCloudServiceRemoteDesktopExtensionObject -Name "RDPExtension" -Credential $credential -Expiration $expiration -TypeHandlerVersion "1.2.1"
# Add RDP extension to existing cloud service extension object
$cloudService.ExtensionProfile.Extension = $cloudService.ExtensionProfile.Extension + $rdpExtension
# Update cloud service
$cloudService | Update-AzCloudService