All settings must be specified using the .rdp file style syntax:
option:type:value
Examples:
alternate shell:s:notepad.exe
keyboardhook:i:2
Note: The information in this overview is largely compiled from this
article at the Microsoft TechNet site.
Overview of available settings
Setting | Type | Default value | Description and possible values | Settable from RDC GUI? | RDP+ equivalent | 5.1 | 5.2 | 6.0 | 6.1 | 7.0 | 7.1 | 8.0 | 8.1 | 10.0 |
administrative session | i | 0 | Connect to the administrative session of the remote computer. 0 – Do not use the |
Command line | /console, /admin | X | X | X | X | X | X | |||
allow desktop composition | i | 0 | Determines whether desktop composition (needed for Aero) is permitted when you log on to the remote computer. 0 – Disable desktop composition |
Yes | X | X | X | X | X | X | X | X | ||
allow font smoothing | i | 0 | Determines whether font smoothing may be used in the remote session. 0 – Disable font smoothing in |
Yes | X | X | X | X | X | X | X | X | ||
alternate full address | s | Specifies an alternate name or IP address of the remote computer that you want to connect to. Will be overruled by RDP+. |
No | X | X | X | X | X | ||||||
alternate shell | s | Specifies a program to be started automatically when you connect to a remote computer. The value should be a valid path to an executable file. This setting only works when connecting to servers. |
Yes | /start | X | X | X | X | X | X | X | X | X | |
audiocapturemode | i | 0 | Determines how sounds captured (recorded) on the local computer are handled when you are connected to the remote computer. 0 – Do not capture audio from |
Yes | X | X | X | X | X | |||||
audiomode | i | 0 | Determines how sounds on a remote computer are handled when you are connected to the remote computer. 0 – Play sounds on the local |
Yes | /[no]sound | X | X | X | X | X | X | X | X | X |
audioqualitymode | i | 0 | Determines the quality of the audio played in the remote session. 0 – Dynamically adjust audio |
No | X | X | X | X | X | |||||
authentication level | i | 2 | Determines what should happen when server authentication fails. 0 – If server authentication This setting will be overruled by |
Yes | X | X | X | X | X | X | X | X | ||
autoreconnect max retries | i | 20 | Determines the maximum number of times the client computer will try to reconnect to the remote computer if the connection is dropped. Note: The maximum value Remote Desktop can handle is 200. |
No | X | X | X | X | X | X | X | X | X | |
autoreconnection enabled | i | 1 | Determines whether the client computer will automatically try to reconnect to the remote computer if the connection is dropped. 0 – Do not attempt to |
Yes | X | X | X | X | X | X | X | X | X | |
bandwidthautodetect | i | 1 | Enables the option for automatic detection of the network type. Used in conjunction with networkautodetect. Also see connection type. 0 – Do not enable the option |
Yes | X | X | X | |||||||
bitmapcachepersistenable | i | 1 | Determines whether bitmaps are cached on the local computer (disk-based cache). Bitmap caching can improve the performance of your remote session. 0 – Do not cache bitmaps. |
Yes | X | X | X | X | X | X | X | X | ||
bitmapcachesize | i | 1500 | Specifies the size in kilobytes of the memory-based bitmap cache. The maximum value is 32000. |
No | X | X | X | X | X | X | X | X | X | |
compression | i | 1 | Determines whether the connection should use bulk compression. 0 – Do not use bulk |
No | X | X | X | X | X | X | X | X | X | |
connect to console | i | 0 | Connect to the console session of the remote computer. 0 – Connect to a normal |
Command line | /console, /admin | X | X | X | ||||||
connection type | i | 2 | Specifies pre-defined performance settings for the Remote Desktop session. 1 – Modem (56 Kbps). By itself, this setting does nothing. |
Yes | X | X | X | X | X | |||||
desktopheight | i | 600 | The height (in pixels) of the remote session desktop. |
Limited | /h | X | X | X | X | X | X | X | X | X |
desktop size id | i | 0 | Specifies pre-defined dimensions of the remote session desktop. 0 – 640×480. This setting is ignored when either |
Yes | X | X | X | X | X | X | X | X | X | |
desktopwidth | i | 800 | The width (in pixels) of the remote session desktop. |
Limited | /w | X | X | X | X | X | X | X | X | X |
devicestoredirect | s | Determines which supported Plug and Play devices on the client computer will be redirected and available in the remote session. No value specified – Do not |
Yes | /[no]drives | X | X | X | X | X | X | X | |||
disable ctrl+alt+del | i | 1 | Determines whether you have to press CTRL+ALT+DELETE before entering credentials after you are connected to the remote computer. 0 – CTRL+ALT+DELETE is required Note: When disabled, this setting |
No | X | X | X | X | X | X | X | X | X | |
disable full window drag | i | 1 | Determines whether window content is displayed when you drag the window to a new location. 0 – Show the contents of the |
Yes | X | X | X | X | X | X | X | X | X | |
disable menu anims | i | 1 | Determines whether menus and windows can be displayed with animation effects in the remote session. 0 – Menu and window animation |
Yes | X | X | X | X | X | X | X | X | X | |
disable themes | i | 0 | Determines whether themes are permitted when you log on to the remote computer. 0 – Themes are permitted. |
Yes | X | X | X | X | X | X | X | X | X | |
disable wallpaper | i | 1 | Determines whether the desktop background is displayed in the remote session. 0 – Display the wallpaper. |
Yes | /[no]wallpaper | X | X | X | X | X | X | X | X | X |
disableconnectionsharing | i | 0 | Determines whether a new Terminal Server session is started with every launch of a RemoteApp to the same computer and with the same credentials. 0 – No new session is started. |
No | X | X | X | X | X | X | X | |||
disableremoteappcapscheck | i | 0 | Specifies whether the Remote Desktop client should check the remote computer for RemoteApp capabilities. 0 – Check the remote computer for RemoteApp capabilities before logging in. 1 – Do not check the remote computer for RemoteApp capabilities.Note: This setting must be set to 1 when connecting to Windows XP SP3, Vista or 7 computers with RemoteApps configured on them. This is the default behavior of RDP+. |
No | X | X | X | X | X | |||||
displayconnectionbar | i | 1 | Determines whether the connection bar appears when you are in full screen mode. 0 – Do not show the connection Will be overruled by RDP+ when using |
Yes | X | X | X | X | X | X | X | X | X | |
domain | s | Specifies the name of the domain of the user. Will be ignored/overruled by RDP+. |
Yes | /u, /domain | X | X | X | X | X | X | X | X | X | |
drivestoredirect | s | Determines which local disk drives on the client computer will be redirected and available in the remote session. No value specified – Do not |
Yes | /[no]drives | X | X | X | X | X | X | X | |||
enablecredsspsupport | i | 1 | Determines whether Remote Desktop will use CredSSP for authentication if it’s available. 0 – Do not use CredSSP, even if |
No | X | X | X | X | X | X | X | |||
enablesuperpan | i | 0 | Determines whether SuperPan is enabled or disabled. SuperPan allows the user to navigate a remote desktop in full-screen mode without scroll bars, when the dimensions of the remote desktop are larger than the dimensions of the current client window. The user can point to the window border, and the desktop view will scroll automatically in that direction. 0 – Do not use SuperPan. The |
No | X | X | X | X | X | |||||
full address | s | Specifies the name or IP address (and optional port) of the remote computer that you want to connect to. Will be ignored by RDP+. |
Yes | /v | X | X | X | X | X | X | X | X | X | |
gatewaycredentialssource | i | 4 | Specifies the credentials that should be used to validate the connection with the RD Gateway. 0 – Ask for password (NTLM). |
Yes | X | X | X | X | X | X | X | |||
gatewayhostname | s | Specifies the hostname of the RD Gateway. |
Yes | /rdgateway | X | X | X | X | X | X | X | |||
gatewayprofileusagemethod | i | 0 | Determines the RD Gateway authentication method to be used. 0 – Use the default profile |
Yes | X | X | X | X | X | X | X | |||
gatewayusagemethod | i | 4 | Specifies if and how to use a Remote Desktop Gateway (RD Gateway) server. 0 – Do not use an RD Gateway 0 and 4 have the same effect, but |
Yes | X | X | X | X | X | X | X | |||
keyboardhook | i | 2 | Determines how Windows key combinations are applied when you are connected to a remote computer. 0 – Windows key combinations |
Yes | X | X | X | X | X | X | X | X | X | |
negotiate security layer | i | 1 | Determines whether the level of security is negotiated or not. 0 – Security layer negotiation |
No | X | X | X | X | X | X | X | |||
networkautodetect | i | 1 | Determines whether to use auomatic network bandwidth detection or not. Requires the option bandwidthautodetect to be set and correlates with connection type 7. 0 – Use automatic network |
Yes | X | X | X | |||||||
password 51 | b | The user password in a binary hash value. Will be overruled by RDP+. |
Yes | /p, /pe, /i | X | X | X | X | X | X | X | X | X | |
pinconnectionbar | i | 1 | Determines whether or not the connection bar should be pinned to the top of the remote session upon connection when in full screen mode. 0 – The connection bar should |
No | X | X | X | X | X | X | X | X | X | |
prompt for credentials | i | 0 | Determines whether Remote Desktop Connection will prompt for credentials when connecting to a remote computer for which the credentials have been previously saved. 0 – Remote Desktop will use the This setting is ignored by RDP+. |
Yes | X | X | X | X | X | X | X | |||
prompt for credentials on client | i | 0 | Determines whether Remote Desktop Connection will prompt for credentials when connecting to a server that does not support server authentication. 0 – Remote Desktop will not This setting is ignored by RDP+. |
No | X | X | X | X | X | X | ||||
promptcredentialonce | i | 1 | When connecting through an RD Gateway, determines whether RDC should use the same credentials for both the RD Gateway and the remote computer. 0 – Remote Desktop will not use |
Yes | X | X | X | X | X | X | ||||
public mode | i | 0 | Determines whether Remote Desktop Connection will be started in public mode. 0 – Remote Desktop will not This setting is incompatible with |
Command line | X | X | X | X | X | |||||
redirectclipboard | i | 1 | Determines whether the clipboard on the client computer will be redirected and available in the remote session and vice versa. 0 – Do not redirect the |
Yes | X | X | X | X | X | X | X | |||
redirectcomports | i | 0 | Determines whether the COM (serial) ports on the client computer will be redirected and available in the remote session. 0 – The COM ports on the local |
Yes | X | X | X | X | X | X | X | X | X | |
redirectdirectx | i | 1 | Determines whether DirectX will be enabled for the remote session. 0 – Do not enable DirectX |
No | X | X | X | X | X | |||||
redirectdrives | i | 0 | Determines whether local disk drives on the client computer will be redirected and available in the remote session. 0 – The drives on the local Note: This setting is replaced by |
Yes | /[no]drives | X | X | |||||||
redirectposdevices | i | 0 | Determines whether Microsoft Point of Service (POS) for .NET devices connected to the client computer will be redirected and available in the remote session. 0 – The POS devices from the |
No | X | X | X | X | X | X | X | |||
redirectprinters | i | 1 | Determines whether printers configured on the client computer will be redirected and available in the remote session. 0 – The printers on the local |
Yes | /[no]printers | X | X | X | X | X | X | X | X | X |
redirectsmartcards | i | 1 | Determines whether smart card devices on the client computer will be redirected and available in the remote session. 0 – The smart card device on |
Yes | X | X | X | X | X | X | X | X | X | |
remoteapplicationcmdline | s | Optional command line parameters for the RemoteApp. |
No | X | X | X | X | X | X | X | ||||
remoteapplicationfile | s | Specifies a file to be opened on the remote computer by the RemoteApp. Note: For local files to be opened, |
No | /remotefile | X | X | X | X | X | X | X | |||
remoteapplicationexpandcmdline | i | 1 | Determines whether environment variables contained in the RemoteApp command line parameter should be expanded locally or remotely. 0 – Environment variables |
No | X | X | X | X | X | X | X | |||
remoteapplicationexpandworkingdir | i | 0 | Determines whether environment variables contained in the RemoteApp working directory parameter should be expanded locally or remotely. 0 – Environment variables Note: The RemoteApp working directory |
No | X | X | X | X | X | X | X | |||
remoteapplicationicon | s | Specifies the file name of an icon file to be displayed in the Remote Desktop interface while starting the RemoteApp. By default RDC will show the standard Remote Desktop icon. Note: Only .ico files are supported. |
No | X | X | X | X | X | X | X | ||||
remoteapplicationmode | i | 0 | Determines whether a RemoteApp shoud be launched when connecting to the remote computer. 0 – Use a normal session and do |
No | /remoteapp | X | X | X | X | X | X | X | ||
remoteapplicationname | s | Specifies the name of the RemoteApp in the Remote Desktop interface while starting the RemoteApp. |
No | X | X | X | X | X | X | X | ||||
remoteapplicationprogram | s | Specifies the alias or executable name of the RemoteApp. |
No | /remoteapp | X | X | X | X | X | X | ||||
screen mode id | i | 2 | Determines whether the remote session window appears full screen when you connect to the remote computer. 1 – The remote session will |
Yes | /f[ullscreen], /fit, /max, /w, /h |
X | X | X | X | X | X | X | X | X |
server port | i | 3389 | Defines an alternate default port for the Remote Desktop connection. Will be overruled by any port number |
Command line | /v | X | X | X | X | X | X | X | X | X |
session bpp | i | 32 | Determines the color depth (in bits) on the remote computer when you connect. 8 – 256 colors (8 bit). |
Yes | X | X | X | X | X | X | X | X | X | |
shell working directory | s | The working directory on the remote computer to be used if an alternate shell is specified. |
Yes | X | X | X | X | X | X | X | X | X | ||
smart sizing | i | 0 | Determines whether the client computer should scale the content on the remote computer to fit the window size of the client computer when the window is resized. 0 – The client window display |
No | X | X | X | X | X | X | X | X | X | |
span monitors | i | 0 | Determines whether the remote session window will be spanned across multiple monitors when you connect to the remote computer. 0 – Monitor spanning is not Note: When using Remote Desktop |
Yes | /span | X | X | X | X | X | X | X | ||
superpanaccelerationfactor | i | 1 | Specifies the number of pixels that the screen view scrolls in a given direction for every pixel of mouse movement by the client when in SuperPan mode |
No | X | X | X | X | X | |||||
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. No value specified – Do not |
Yes | X | X | X | X | |||||||
use multimon | i | 0 | Determines whether the session should use true multiple monitor support when connecting to the remote computer. 0 – Do not enable multiple |
Yes | /multimon | X | X | X | X | X | ||||
username | s | Specifies the name of the user account that will be used to log on to the remote computer. Will be ignored by RDP+. |
Yes | /u | X | X | X | X | X | X | X | X | X | |
videoplaybackmode | i | 1 | Determines whether RDC will use RDP efficient multimedia streaming for video playback. 0 – Do not use RDP efficient |
No | X | X | X | X | X | |||||
winposstr | s | 0,3,0,0,800,600 | Specifies the position and dimensions of the session window on the client computer. Will be overruled by RDP+. |
No | /f[ullscreen], /fit, /max, /w, /h, /pos |
X | X | X | X | X | X | X | X | X |
5.1 : Included with Windows XP.
5.2 : Included with Windows 2003.
6.0 :
Included with Windows Vista. Available for Windows XP SP2 and Windows 2003 SP1/SP2.
6.1 : Included with Windows 2008, Windows Vista SP1 and Windows XP SP3. Available
for Windows XP SP2.
7.0 : Included with Windows 2008 R2 and Windows 7.
Available for Windows XP SP3 and Windows Vista SP1/SP2.7.1 : Included with Windows
7 SP1 and Windows 2008 R2 SP1.
8.0 : Included with Windows 8 and Windows
2012. Available for Windows 7 SP1 and Windows 2008 R2 SP1.
8.1 : Included
with Windows 8.1 and Windows 2012 R2. Available for Windows 7 SP1 and Windows 2008
R2 SP1.
10.0: Included with Windows 10.