Customize Remote Desktop Protocol properties for a host pool

Customizing a host pool's Remote Desktop Protocol (RDP) properties, such as multi-monitor experience and audio redirection, lets you deliver an optimal experience for your users based on their needs. You can customize RDP properties in Windows Virtual Desktop using the -CustomRdpProperty parameter in the Set-RdsHostPool cmdlet.

See supported RDP file settings for a full list of supported properties and their default values.

First, download and import the Windows Virtual Desktop PowerShell module to use in your PowerShell session if you haven't already. After that, run the following cmdlet to sign in to your account:

Add-RdsAccount -DeploymentUrl "https://rdbroker.wvd.microsoft.com"

Default RDP properties

By default, published RDP files contain the following properties:

RDP properties Desktops RemoteApps
Multi-monitor mode Enabled N/A
Drive redirections enabled Drives, clipboard, printers, COM ports, USB devices and smartcards Drives, clipboard, and printers
Remote audio mode Play locally Play locally

Any custom properties you define for the host pool will override these defaults.

Add or edit a single custom RDP property

To add or edit a single custom RDP property, run the following PowerShell cmdlet:

Set-RdsHostPool -TenantName <tenantname> -Name <hostpoolname> -CustomRdpProperty "<property>"

A screenshot of PowerShell cmdlet Get-RDSRemoteApp with Name and FriendlyName highlighted.

Add or edit multiple custom RDP properties

To add or edit multiple custom RDP properties, run the following PowerShell cmdlets by providing the custom RDP properties as a semicolon-separated string:

$properties="<property1>;<property2>;<property3>"
Set-RdsHostPool -TenantName <tenantname> -Name <hostpoolname> -CustomRdpProperty $properties

A screenshot of PowerShell cmdlet Get-RDSRemoteApp with Name and FriendlyName highlighted.

Reset all custom RDP properties

You can reset individual custom RDP properties to their default values by following the instructions in Add or edit a single custom RDP property, or you can reset all custom RDP properties for a host pool by running the following PowerShell cmdlet:

Set-RdsHostPool -TenantName <tenantname> -Name <hostpoolname> -CustomRdpProperty ""

A screenshot of PowerShell cmdlet Get-RDSRemoteApp with Name and FriendlyName highlighted.

Next steps

Now that you've customized the RDP properties for a given host pool, you can sign in to a Windows Virtual Desktop client to test them as part of a user session. These next two How-tos will tell you how to connect to a session using the client of your choice: