Windows Virtual Desktop (App ID 9cdead84-a844-4324-93f2-b2e6bb768d07). To learn more about customizing RDP properties for a host pool using PowerShell or the Azure portal, check out RDP properties. For the full list of supported RDP properties, see Supported RDP file settings. Where to define RDP properties First of all you can define RDP properties from within the Azure Portal. To find them, simply logon to the Azure Portal on and navigate to the Windows Virtual Desktop service by using the search bar or using the quick link. To find the properties you must have at least one Host Pool in place.
-->Important
This content applies to Windows Virtual Desktop (classic), which doesn't support Azure Resource Manager Windows Virtual Desktop objects. If you're trying to manage Azure Resource Manager Windows Virtual Desktop objects, see this article.
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:
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
Windows Virtual Desktop Rdp Custom Properties
To add or edit a single custom RDP property, run the following PowerShell cmdlet:
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:
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:
Next steps
Custom Rdp Properties
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:
Microsoft recently updated Teams to make it even easier to use audio/video within WVD! While the blog post below may still be useful, check out our more recent post on Enabling Audio and Video for Microsoft Teams on Windows Virtual Desktop using Media Optimizations. If you prefer using Audio & Video Redirection instead of Media Optimizations, you can now even configure that without PowerShell (if you created your tenant via the Azure Portal). Check out that post here: Edit Windows Virtual Desktop Properties in the Azure Portal.
Looking to let users leverage Teams through Windows Virtual Desktop(WVD)? No problem! To enable Audio/Video redirection, we'll need to set the following custom RDP properties:
audiocapturemode:i:1enables audio capture from the local device and redirects audio applications in the remote session.audiomode:i:0plays audio on the local computer.camerastoredirect:s:*redirects all cameras.
To do this, all we need to do is run two PowerShell commands against our WVD tenant:
(This does assume you have the WVD PowerShell and Az modules installed, which were also required for standing up WVD)
You can use this command to set any of the RDP settings, which can be found here: https://docs.microsoft.com/en-us/windows-server/remote/remote-desktop-services/clients/rdp-files. For example, if you're looking to disable clipboard access as well, the command would be:
Once that's configured, if you open the Remote Desktop client (download for Windows 7/10 here) you will see Remote Audio and Camera working in Teams:
Now – you may notice that through the HTML5 WVD connection, there is no microphone input device under settings:
This is because, unfortunately, HTML5 does not support Audio Redirection:
Windows Virtual Desktop Rdp Properties List
So make sure you keep on eye out on which settings are supported! The supportability is listed on the same site as the settings. Happy deploying! 💻
