On this page you will find an overview of most of the available .rdp file settings which can be used with the /o command line switch.
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, supplemented with this article.
Use the search box on the left to search and filter keywords.
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 administrative session. 1 - Connect to the administrative session. | 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 in the remote session. 1 - Desktop composition is permitted. | 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 the remote session. 1 - Font smoothing is permitted. | 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 the local computer. 1 - Capture audio from the local computer and send to the remote computer. | 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 computer. 1 - Play sounds on the remote computer. 2 - Do not play sounds. | 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 quality based on available bandwidth. 1 - Always use medium audio quality. 2 - Always use uncompressed audio quality. | No | X | X | X | X | X | |||||
| authentication level | i | 2 | Determines what should happen when server authentication fails. 0 - If server authentication fails, connect without giving a warning. 1 - If server authentication fails, do not connect. 2 - If server authentication fails, show a warning and allow the user to connect or not. 3 - Server authentication is not required. This setting will be overruled by RDP+. | 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 reconnect. 1 - Attempt to reconnect. | 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 for automatic network detection. 1 - Enable the option for automatic network detection. | 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. 1 - 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 | |
| camerastoredirect | s | Configures which cameras to redirect. This setting uses a semicolon-delimited list of KSCATEGORY_VIDEO_CAMERA interfaces of cameras enabled for redirection. | No | X | ||||||||||
| compression | i | 1 | Determines whether the connection should use bulk compression. 0 - Do not use bulk compression. 1 - Use bulk compression. | 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 session. 1 - Connect to the console screen. | 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). 2 - Low-speed broadband (256 Kbps - 2 Mbps). 3 - Satellite (2 Mbps - 16 Mbps with high latency). 4 - High-speed broadband (2 Mbps - 10 Mbps). 5 - WAN (10 Mbps or higher with high latency). 6 - LAN (10 Mbps or higher). 7 - Automatic bandwidth detection. Requires bandwidthautodetect. By itself, this setting does nothing. When selected in the RDC GUI, this option changes several performance related settings (themes, animation, font smoothing, etcetera). These separate settings always overrule the connection type setting. | 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 - 640x480. 1 - 800x600. 2 - 1024x768. 3 - 1280x1024. 4 - 1600x1200. This setting is ignored when either /w and /h, or desktopwidth and desktopheight are already specified. | 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 redirect any supported Plug and Play devices. * - Redirect all supported Plug and Play devices, including ones that are connected later. DynamicDevices - Redirect any supported Plug and Play devices that are connected later. The hardware ID for one or more Plug and Play devices - Redirect the specified supported Plug and Play device(s). | 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 before logging in. 1 - CTRL+ALT+DELETE is not required. You can logon immediately. Note: When disabled, this setting will also delay the autologin until the user has pressed CTRL+ALT+DELETE. | 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 window while dragging. 1 - Show an outline of the window while dragging. | 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 is permitted. 1 - No 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. 1 - Disable theme in the remote session. | 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. 1 - Do not show any 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. The currently active session of the user is shared. 1 - A new login session is started for the RemoteApp. | 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 bar. 1 - Show the connection bar. Will be overruled by RDP+ when using the parameter /noclose. | 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 redirect any drives. * - Redirect all disk drives, including drives that are connected later. DynamicDrives - Redirect any drives that are connected later. The drive and labels for one or more drives - Redirect the specified drive(s). | 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 the operating system supports it. 1 - Use CredSSP, if the operating system supports it. | 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 remote session window is sized to the client window size. 1 - Enable SuperPan. The remote session window is sized to the dimensions specified through /w and /h, or through desktopwidth and desktopheight. | No | X | X | X | X | X | |||||
| encode redirected video capture | i | 1 | Enables or disables encoding of redirected video. 0 - Disable encoding of redirected video. 1 - Enable encoding of redirected video. | No | 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). 1 - Use smart card. 4 - Allow user to select later. | Yes | X | X | X | X | X | X | X | |||
| gatewayhostname | s | Specifies the hostname of the RD Gateway. | Yes | /g | X | X | X | X | X | X | X | |||
| gatewayprofileusagemethod | i | 0 | Determines the RD Gateway authentication method to be used. 0 - Use the default profile mode, as specified by the administrator. 1 - Use explicit settings. | 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 server. 1 - Always use an RD Gateway, even for local connections. 2 - Use the RD Gateway if a direct connection cannot be made to the remote computer (i.e. bypass for local addresses). 3 - Use the default RD Gateway settings. 4 - Do not use an RD Gateway server. 0 and 4 have the same effect, but setting the method to 4 also sets the option for bypassing local addresses in the Remote Desktop user interface. | 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 are applied on the local computer. 1 - Windows key combinations are applied on the remote computer. 2 - Windows key combinations are applied in full-screen mode only. | 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 is not enabled and the session is started by using Secure Sockets Layer (SSL). 1 - Security layer negotiation is enabled and the session is started by using x.224 encryption. | 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 bandwitdh detection. 1 - Do not use automatic network bandwitdh detection. | 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 not be pinned to the top of the remote session. 1 - The connection bar should be pinned to the top of the remote session. | 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 saved credentials and will not prompt for credentials. 1 - Remote Desktop will prompt for credentials. 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 prompt for credentials. 1 - Remote Desktop will prompt for credentials. 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 the same credentials . 1 - Remote Desktop will use the same credentials for both the RD gateway and the remote computer. | 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 start in public mode . 1 - Remote Desktop will start in public mode and will not save any user data (credentials, bitmap cache, MRU) on the local machine. This setting is incompatible with autologin and some other features and therefore ignored by RDP+. | Command line | X | X | X | X | X | |||||
| redirected video capture encoding quality | i | 0 | Controls the quality of encoded video. 0 - High compression video. Quality may suffer when there's a lot of motion. 1 - Medium compression. 2 - Low compression video with high picture quality. | No | 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 clipboard. 1 - Redirect the clipboard. | 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 computer are not available in the remote session. 1 - The COM ports on the local computer are available in the remote session. | 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 rendering. 1 - Enable DirectX rendering in the remote session. | 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 computer are not available in the remote session. 1 - The drives on the local computer are available in the remote session. Note: This setting is replaced by drivestoredirect from RDC 6.0 onward. | Yes | /[no]drives | X | X | |||||||
| redirectlocation | i | 0 | Determines whether the location of the local device will be redirected and available in the remote session. 0 - The remote session uses the location of the remote computer. 1 - The remote session uses the location of the local device. | No | 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 local computer are not available in the remote session. 1 - The POS devices from the local computer are available in the remote session. | 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 computer are not available in the remote session. 1 - The printers on the local computer are available in the remote session. | 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 the local computer is not available in the remote session. 1 - The smart card device on the local computer is available in the remote session. | Yes | X | X | X | X | X | X | X | X | X | |
| 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). 0 - WebAuthn requests from the remote session aren't sent to the local computer for authentication and must be completed in the remote session. 1 - WebAuthn requests from the remote session are sent to the local computer for authentication. | 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, you must also enable drive redirection for (at least) the source drive. | 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 should be expanded to the values of the local computer. 1 - Environment variables should be expanded on the remote computer to the values of the remote computer. | 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 should be expanded to the values of the local computer. 1 - Environment variables should be expanded on the remote computer to the values of the remote computer. Note: The RemoteApp working directory is specified through the shell working directory parameter. | 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 not start a RemoteApp. 1 - Connect and launch a RemoteApp. | 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 appear in a window. 2 - The remote session will appear full screen. | Yes | /f, /fit, /max, /w, /h | X | X | X | X | X | X | X | X | X |
| selectedmonitors | s | Specifies which local displays to use for the remote session. The selected displays must be contiguous. Requires use multimon to be set to 1. Comma separated list of machine-specific display IDs. You can retrieve IDs by calling mstsc.exe /l. The first ID listed will be set as the primary display in the session. Defaults to all displays. | No | X | ||||||||||
| server port | i | 3389 | Defines an alternate default port for the Remote Desktop connection. Will be overruled by any port number appended to the server name. | 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). 15 - High color (15 bit). 16 - High color (16 bit). 24 - True color (24 bit). 32 - Highest quality (32 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 | ||
| signature | s | The encoded signature when using .rdp file signing. Will be overruled by RDP+. | No | X | X | X | X | X | X | |||||
| signscope | s | Comma-delimited list of .rdp file settings for which the signature is generated when using .rdp file signing. Will be overruled by RDP+. | No | 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 will not be scaled when resized. 1 - The client window display will be scaled when resized. | 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 enabled. 1 - Monitor spanning is enabled. Note: When using Remote Desktop Connection 7 (Windows 7/2008), the use multimon setting is recommended. | 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 redirect any supported RemoteFX USB devices. * - Redirect all supported RemoteFX USB devices for redirection that are not redirected by high-level redirection mechanisms. {Device Setup Class GUID} - Redirect all supported RemoteFX USB devices that are members of the specified device setup class. USB\InstanceID - Redirect the supported RemoteFX USB device specified by the given instance ID. -USB\InstanceID - Do not redirect the supported RemoteFX USB device specified by the given instance ID, even if the device is in a device setup class that is redirected.. | 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 monitor support. 1 - Enable multiple monitor support. | 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 multimedia streaming for video playback. 1 - Use RDP efficient multimedia streaming for video playback when possible. | 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, /fit, /max, /w, /h, /pos | X | X | X | X | X | X | X | X | X |
| workspaceid | s | This setting defines the RemoteApp and Desktop ID associated with the RDP file that contains this setting. | No | X | X | X | X | X |
RDC versions
5.1 : Included with Windows XP.
5.2 : Included with Windows Server 2003.
6.0 : Included with Windows Vista. Available for Windows XP SP2 and Windows Server 2003 SP1/SP2.
6.1 : Included with Windows XP SP3, Windows Vista SP1 and Windows Server 2008. Available for Windows XP SP2.
7.0 : Included with Windows 7 and Windows Server 2008 R2. Available for Windows XP SP3 and Windows Vista SP1/SP2.
7.1 : Included with Windows 7 SP1 and Windows Server 2008 R2 SP1.
8.0 : Included with Windows 8 and Windows Server 2012. Available for Windows 7 SP1 and Windows Server 2008 R2 SP1.
8.1 : Included with Windows 8.1 and Windows Server 2012 R2. Available for Windows 7 SP1 and Windows Server 2008 R2 SP1.
10.0: Included with Windows 10, Windows 11, Windows Server 2016, Windows Server 2019 and Windows Server 2022.