|
3 | 3 | | Display name | RDP property | Azure Virtual Desktop | Remote Desktop Services | Description | Values | Default value |
|
4 | 4 | |--|--|:-:|:-:|--|--|:-:|
|
5 | 5 | | Azure AD authentication | enablerdsaadauth:i:*value* | ✔ | ✔ | Determines whether the client will use Azure AD to authenticate to the remote PC if it's available.<br /><br />Note: Available in preview for Windows and web clients only currently. This replaces the property `targetisaadjoined`. | - 0: RDP won't use Azure AD authentication, even if the remote PC supports it.<br />- 1: RDP will use Azure AD authentication if the remote PC supports it. | 0 |
|
6 |
| -| Azure AD authentication | targetisaadjoined:i:*value* | ✔ | ✗ | Allows connections to Azure AD-joined session hosts using username and password.<br /><br />Note: only applicable to non-Windows clients and local Windows devices that are not joined to Azure AD. | 0: connections to Azure AD-joined session hosts will succeed for Windows devices that [meet the requirements](/azure/virtual-desktop/deploy-azure-ad-joined-vm.md#connect-using-the-windows-desktop-client), but other connections will fail.<br />1: connections to Azure AD-joined hosts will succeed but are restricted to entering user name and password credentials when connecting to session hosts. | 0 | |
| 6 | +| Azure AD authentication | targetisaadjoined:i:*value* | ✔ | ✗ | Allows connections to Azure AD-joined session hosts using username and password.<br /><br />Note: only applicable to non-Windows clients and local Windows devices that are not joined to Azure AD. | - 0: connections to Azure AD-joined session hosts will succeed for Windows devices that [meet the requirements](/azure/virtual-desktop/deploy-azure-ad-joined-vm.md#connect-using-the-windows-desktop-client), but other connections will fail.<br />- 1: connections to Azure AD-joined hosts will succeed but are restricted to entering user name and password credentials when connecting to session hosts. | 0 | |
7 | 7 | | Credential Security Support Provider | enablecredsspsupport:i:*value* | ✔ | ✔ | Determines whether the client will use the Credential Security Support Provider (CredSSP) for authentication if it's available. | - 0: RDP won't use CredSSP, even if the operating system supports CredSSP.<br />- 1: RDP will use CredSSP if the operating system supports CredSSP. | 1 |
|
8 | 8 | | Alternate shell | alternate shell:s:*value* | ✔ | ✔ | Specifies a program to be started automatically in the remote session as the shell instead of explorer. | Valid path to an executable file, such as `C:\ProgramFiles\Office\word.exe`. | None |
|
9 | 9 | | KDC proxy name | kdcproxyname:s:*value* | ✔ | ✗ | Specifies the fully qualified domain name of a KDC proxy. | Valid path to a KDC proxy server, such as `kdc.contoso.com`. | None |
|
|
25 | 25 | |--|--|:-:|:-:|--|--|:-:|
|
26 | 26 | | Reconnection | autoreconnection enabled:i:*value* | ✔ | ✔ | Determines whether the client will automatically try to reconnect to the remote computer if the connection is dropped, such as when there's a network connectivity interruption. | - 0: Client doesn't automatically try to reconnect.<br />- 1: Client automatically tries to reconnect. | 1 |
|
27 | 27 | | Bandwidth auto detect | bandwidthautodetect:i:*value* | ✔ | ✔ | Determines whether or not to use automatic network bandwidth detection. Requires bandwidthautodetect to be set to 1. | - 0: Disable automatic network type detection.<br />- 1: Enable automatic network type detection. | 1 |
|
28 |
| -| Network auto detect | networkautodetect:i:*value* | ✔ | ✔ | Determines whether automatic network type detection is enabled. | - 0: Don't use automatic network bandwidth detection.<br /> - 1: Use automatic network bandwidth detection. | 1 | |
| 28 | +| Network auto detect | networkautodetect:i:*value* | ✔ | ✔ | Determines whether automatic network type detection is enabled. | - 0: Don't use automatic network bandwidth detection.<br />- 1: Use automatic network bandwidth detection. | 1 | |
29 | 29 | | Compression | compression:i:*value* | ✔ | ✔ | Determines whether bulk compression is enabled when it's transmitted by RDP to the local computer. | - 0: Disable RDP bulk compression.<br />- 1: Enable RDP bulk compression. | 1 |
|
30 | 30 | | Video playback | videoplaybackmode:i:*value* | ✔ | ✔ | Determines if the connection will use RDP-efficient multimedia streaming for video playback. | - 0: Don't use RDP efficient multimedia streaming for video playback.<br />- 1: Use RDP-efficient multimedia streaming for video playback when possible. | 1 |
|
31 | 31 |
|
|
40 | 40 | | Redirect video encoding | encode redirected video capture:i:*value* | ✔ | ✔ | Enables or disables encoding of redirected video. | - 0: Disable encoding of redirected video.<br />- 1: Enable encoding of redirected video. | 1 |
|
41 | 41 | | Encoded video quality | redirected video capture encoding quality:i:*value* | ✔ | ✔ | Controls the quality of encoded video. | - 0: High compression video. Quality may suffer when there's a lot of motion. <br />- 1: Medium compression.<br />- 2: Low compression video with high picture quality. | 0 |
|
42 | 42 | | Audio output location | audiomode:i:*value* | ✔ | ✔ | Determines whether the local or remote machine plays audio. | - 0: Play sounds on the local computer.<br />- 1: Play sounds on the remote computer.<br />- 2: Don't play sounds. | 0 |
|
43 |
| -| Camera redirection | camerastoredirect:s:*value* | ✔ | ✔ | Configures which cameras to redirect. This setting uses a semicolon-delimited list of `KSCATEGORY_VIDEO_CAMERA` interfaces of cameras enabled for redirection. | - * : Redirect all cameras.<br /> - List of cameras, such as `\\?\usb#vid_0bda&pid_58b0&mi`.<br />- You can exclude a specific camera by prepending the symbolic link string with "-". | Don't redirect any cameras. | |
44 |
| -| Media Transfer Protocol (MTP) and Picture Transfer Protocol (PTP) | devicestoredirect:s:*value* | ✔ | ✔ | Determines which devices on the local computer will be redirected and available in the remote session. | - *: Redirect all supported devices, including ones that are connected later.<br /> - Valid hardware ID for one or more devices.<br /> - DynamicDevices: Redirect all supported devices that are connected later. | Don't redirect any devices. | |
| 43 | +| Camera redirection | camerastoredirect:s:*value* | ✔ | ✔ | Configures which cameras to redirect. This setting uses a semicolon-delimited list of `KSCATEGORY_VIDEO_CAMERA` interfaces of cameras enabled for redirection. | - * : Redirect all cameras.<br />- List of cameras, such as `\\?\usb#vid_0bda&pid_58b0&mi`.<br />- You can exclude a specific camera by prepending the symbolic link string with "-". | Don't redirect any cameras. | |
| 44 | +| Media Transfer Protocol (MTP) and Picture Transfer Protocol (PTP) | devicestoredirect:s:*value* | ✔ | ✔ | Determines which devices on the local computer will be redirected and available in the remote session. | - *: Redirect all supported devices, including ones that are connected later.<br />- Valid hardware ID for one or more devices.<br />- DynamicDevices: Redirect all supported devices that are connected later. | Don't redirect any devices. | |
45 | 45 | | Drive/storage redirection | drivestoredirect:s:*value* | ✔ | ✔ | Determines which disk drives on the local computer will be redirected and available in the remote session. | - No value specified: don't redirect any drives.<br />- * : Redirect all disk drives, including drives that are connected later.<br />- DynamicDrives: redirect any drives that are connected later.<br />- The drive and labels for one or more drives, such as `drivestoredirect:s:C\:;E\:;`, redirect the specified drive(s). | Don't redirect any drives. |
|
46 | 46 | | Windows key combinations | keyboardhook:i:*value* | ✔ | ✔ | Determines when Windows key combinations (<kbd>Windows</kbd>, <kbd>Alt</kbd>+<kbd>Tab</kbd>) are applied to the remote session for desktop and RemoteApp connections. | - 0: Windows key combinations are applied on the local computer.<br />- 1: (Desktop only) Windows key combinations are applied on the remote computer when in focus.<br />- 2: (Desktop only) Windows key combinations are applied on the remote computer in full screen mode only.<br />- 3: (RemoteApp only) Windows key combinations are applied on the RemoteApp when in focus. We recommend you use this value only when publishing the Remote Desktop Connection app (`mstsc.exe`) from the host pool on Azure Virtual Desktop. This value is only supported when using the [Windows client](/azure/virtual-desktop/users/connect-windows.md). | 2 |
|
47 | 47 | | Clipboard redirection | redirectclipboard:i:*value* | ✔ | ✔ | Determines whether clipboard redirection is enabled. | - 0: Clipboard on local computer isn't available in remote session.<br />- 1: Clipboard on local computer is available in remote session. | 1 |
|
|
50 | 50 | | Printer redirection | redirectprinters:i:*value* | ✔ | ✔ | Determines whether printers configured on the local computer will be redirected and available in the remote session. | - 0: The printers on the local computer aren't available in the remote session.<br />- 1: The printers on the local computer are available in the remote session. | 1 |
|
51 | 51 | | Smart card redirection | redirectsmartcards:i:*value* | ✔ | ✔ | Determines whether smart card devices on the local computer will be redirected and available in the remote session. | - 0: The smart card device on the local computer isn't available in the remote session.<br />- 1: The smart card device on the local computer is available in the remote session. | 1 |
|
52 | 52 | | WebAuthn redirection | redirectwebauthn:i:*value* | ✔ | ✔ | 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). | - 0: WebAuthn requests from the remote session aren't sent to the local computer for authentication and must be completed in the remote session.<br />- 1: WebAuthn requests from the remote session are sent to the local computer for authentication. | 1 |
|
53 |
| -| USB device redirection | usbdevicestoredirect:s:*value* | ✔ | ✔ | 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. | - \*: Redirect all USB devices that aren't already redirected by another high-level redirection.<br /> - {*Device Setup Class GUID*}: Redirect all devices that are members of the specified [device setup class](/windows-hardware/drivers/install/system-defined-device-setup-classes-available-to-vendors/).<br /> - *USBInstanceID*: Redirect a specific USB device identified by the instance ID. | Don't redirect any USB devices. | |
| 53 | +| USB device redirection | usbdevicestoredirect:s:*value* | ✔ | ✔ | 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. | - \*: Redirect all USB devices that aren't already redirected by another high-level redirection.<br />- {*Device Setup Class GUID*}: Redirect all devices that are members of the specified [device setup class](/windows-hardware/drivers/install/system-defined-device-setup-classes-available-to-vendors/).<br />- *USBInstanceID*: Redirect a specific USB device identified by the instance ID. | Don't redirect any USB devices. | |
54 | 54 |
|
55 | 55 | ## Display settings
|
56 | 56 |
|
|
74 | 74 | |--|--|:-:|:-:|--|--|:-:|
|
75 | 75 | | Command-line parameters | remoteapplicationcmdline:s:value | ✗ | ✔ | Optional command-line parameters for the RemoteApp. | Valid command-line parameters. | N/A |
|
76 | 76 | | Command-line variables | remoteapplicationexpandcmdline:i:value | ✗ | ✔ | Determines whether environment variables contained in the RemoteApp command-line parameter should be expanded locally or remotely. | - 0: Environment variables should be expanded to the values of the local computer.<br />- 1: Environment variables should be expanded to the values of the remote computer. | 1 |
|
77 |
| -| Working directory variables | remoteapplicationexpandworkingdir:i:value | ✗ | ✔ | Determines whether environment variables contained in the RemoteApp working directory parameter should be expanded locally or remotely. | - 0: Environment variables should be expanded to the values of the local computer.<br /> - 1: Environment variables should be expanded to the values of the remote computer.<br />The RemoteApp working directory is specified through the shell working directory parameter. | 1 | |
| 77 | +| Working directory variables | remoteapplicationexpandworkingdir:i:value | ✗ | ✔ | Determines whether environment variables contained in the RemoteApp working directory parameter should be expanded locally or remotely. | - 0: Environment variables should be expanded to the values of the local computer.<br />- 1: Environment variables should be expanded to the values of the remote computer.<br />The RemoteApp working directory is specified through the shell working directory parameter. | 1 | |
78 | 78 | | Open file | remoteapplicationfile:s:value | ✗ | ✔ | Specifies a file to be opened on the remote computer by the RemoteApp.<br />For local files to be opened, you must also enable drive redirection for the source drive. | Valid file path. | N/A |
|
79 | 79 | | Icon file | remoteapplicationicon:s:value | ✗ | ✔ | Specifies the icon file to be displayed in the client UI while launching a RemoteApp. If no file name is specified, the client will use the standard Remote Desktop icon. Only `.ico` files are supported. | Valid file path. | N/A |
|
80 | 80 | | Application mode | remoteapplicationmode:i:value | ✗ | ✔ | Determines whether a connection is launched as a RemoteApp session. | - 0: Don't launch a RemoteApp session.<br />- 1: Launch a RemoteApp session. | 1 |
|
|
0 commit comments