Skip to content

Commit 929f1aa

Browse files
sipastakdknappettmsft
authored andcommitted
updates
1 parent 860ac28 commit 929f1aa

File tree

1 file changed

+13
-18
lines changed

1 file changed

+13
-18
lines changed

articles/virtual-desktop/customize-rdp-properties.md

Lines changed: 13 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -12,13 +12,13 @@ ms.custom: devx-track-azurepowershell, docs_inherited
1212
>[!IMPORTANT]
1313
>This content applies to Azure Virtual Desktop with Azure Resource Manager Azure Virtual Desktop objects. If you're using Azure Virtual Desktop (classic) without Azure Resource Manager objects, see [this article](./virtual-desktop-fall-2019/customize-rdp-properties-2019.md).
1414
15-
You can customize a host pool's Remote Desktop Protocol (RDP) properties, such as multi-monitor experience and audio redirection, to deliver an optimal experience for your users based on their needs. If you'd like to change the default RDP file properties, you can customize RDP properties in Azure Virtual Desktop by either using the Azure portal or by using the `-CustomRdpProperty` parameter in the `Update-AzWvdHostPool` cmdlet.
15+
When users sign in to Windows App or the Remote Desktop app, all desktops and applications that they have access to are shown. For each of these, there is a corresponding `.rdp` file that contains all the connection properties to use in the remote session. These RDP properties are set on the host pool.
1616

17-
See [Supported RDP properties with Azure Virtual Desktop](rdp-properties.md) for a full list of supported properties and their default values.
17+
This article shows you how to set the host pool RDP properties using the Azure portal, Azure PowerShell and Azure CLI.
1818

1919
## Default host pool RDP properties
2020

21-
RDP files have the following properties by default:
21+
Host pools have the following RDP properties by default:
2222

2323
|Name |RDP Property |Details |
2424
|---------|---------|---------|
@@ -29,20 +29,16 @@ RDP files have the following properties by default:
2929
| Drive/storage redirection |`drivestoredirect:s:*` |Determines which disk drives on the local computer will be redirected and available in the remote session. |
3030
|Printer redirection | `redirectprinters:i:1` | Determines whether printers configured on the local computer will be redirected and available in the remote session. |
3131
| Media Transfer Protocol (MTP) and Picture Transfer Protocol (PTP) |`devicestoredirect:s:*` | Determines which devices on the local computer will be redirected and available in the remote session. |
32-
|Multiple displays | `use multimon:i:1` | Determines whether the remote session will use one or multiple displays from the local computer. |
32+
|Multiple displays | `use multimon:i:1` | Determines whether the remote session will use one or multiple displays from the local computer. Only applicable for desktop application groups. It's ignored for RemoteApp application groups. |
3333
| Smart card redirection | `redirectsmartcards:i:1` | Determines whether smart card devices on the local computer will be redirected and available in the remote session. |
3434
|USB device redirection | `usbdevicestoredirect:s:*` | Determines which supported RemoteFX USB devices on the client computer will be redirected and available in the remote session when you connect to a remote session that supports RemoteFX USB redirection. |
3535
|Video playback | `videoplaybackmode:i:1` | Determines if the connection will use RDP-efficient multimedia streaming for video playback. |
3636
|WebAuthn redirection | `redirectwebauthn:i:1` | Determines whether WebAuthn requests on the remote computer will be redirected to the local computer allowing the use of local authenticators (such as Windows Hello for Business and security key). |
3737

38+
See [Supported RDP properties with Azure Virtual Desktop](rdp-properties.md) for a full list of supported properties and their default values.
39+
3840

3941
>[!IMPORTANT]
40-
>- Multi-monitor mode is only enabled for Desktop application groups and will be ignored for RemoteApp application groups.
41-
>
42-
>- All default RDP file properties are exposed in the Azure Portal.
43-
>
44-
>- A null CustomRdpProperty field will apply all default RDP properties to your host pool. An empty CustomRdpProperty field won't apply any default RDP properties to your host pool.
45-
>
4642
>- If you also configure device redirection settings using Group Policy objects (GPOs), the settings in the GPOs will override the RDP properties you specify on the host pool.
4743
4844
## Prerequisites
@@ -117,6 +113,9 @@ Name : 0301HP
117113
CustomRdpProperty : audiocapturemode:i:1;audiomode:i:0;
118114
```
119115

116+
>[!IMPORTANT]
117+
>- A null CustomRdpProperty field will apply all default RDP properties to your host pool. An empty CustomRdpProperty field won't apply any default RDP properties to your host pool.
118+
120119

121120
### Remove all RDP properties
122121

@@ -166,6 +165,8 @@ To add or edit multiple custom RDP properties in Azure CLI:
166165
--name $hostPoolName
167166
```
168167
168+
>[!IMPORTANT]
169+
>- A null CustomRdpProperty field will apply all default RDP properties to your host pool. An empty CustomRdpProperty field won't apply any default RDP properties to your host pool.
169170
170171
### Remove all RDP properties
171172
@@ -192,12 +193,6 @@ To remove all custom RDP properties:
192193
---
193194
194195
195-
## Next steps
196-
197-
Now that you've customized the RDP properties for a given host pool, you can sign in to an Azure Virtual Desktop client to test them as part of a user session. These next how-to guides will tell you how to connect to a session using the client of your choice:
196+
## Related content
198197
199-
- [Connect with the Windows Desktop client](./users/connect-windows.md)
200-
- [Connect with the web client](./users/connect-web.md)
201-
- [Connect with the Android client](./users/connect-android-chrome-os.md)
202-
- [Connect with the macOS client](./users/connect-macos.md)
203-
- [Connect with the iOS client](./users/connect-ios-ipados.md)
198+
- [Supported RDP properties with Azure Virtual Desktop](rdp-properties.md)

0 commit comments

Comments
 (0)