RDP Settings are stored in the RDP file used to launch the connection. When you launch, the settings are passed to the endpoint. The following table shows the RDP settings available in in RDC 7 to connect to Windows 7 and Windows Server 2008 R2 endpoints.
Not all RDP settings will be specified in all RDP files. All RDP settings follow the this format: name of setting:datatype:value.
The name of setting is in the Setting column; the datatype is either i (for integer) or s (for string).The value is the string or integer representing the desired behaviour. Most RDP settings are integers; the ones that are strings are the ones that can’t have a default (e.g., the setting to define the command-line settings for an RDP file).
If an RDP setting conflicts with a setting configured through Group Policy or RD Configuration, the settings in the RDP file settings always have lowest precedence.
|Administrative session||Creates an administrative session. This is equivalent to starting the session with /admin.||0|
|Allow font smoothing||Enables font smoothing, which improves the appearance of TrueType fonts.||1|
|Alternate full address||Specifies an alternate name or IP address of the remote computer that you want to connect to by using Remote Desktop Connection (RDC). This setting will override the full address.||The DNS name of the farm or server (e.g., farm.ash.com) or the IPv4 or IPv6 address.|
|Alternate shell||Indicates the application to start for RemoteApp programs||Name of the application executable|
|Audiocapturemode||Determines whether audio capture is enabled. Corresponds to the Remote audio area on the Local Resources tab under Options in RDC. Available settings are 1 (enable capture) and 0 (disable capture).||0|
|Audiomode||Determines how sounds on a remote computer are handled when you are connected to the remote computer by using Remote Desktop Connection (RDC).
Corresponds to the settings in the Remote audio area on the Local Resources tab under Options in RDC. There are three settings: 0 (play sounds on local computer), 1 (play sounds on remote computer) and 2 (do not play).
|Audioqualitymode||Determines the quality of the audio played in the remote session. Possible settings are 0 (adjust audio quality based on bandwidth), 1 (always use medium quality) and 2 (always use uncompressed quality). This setting only has any effect if audio redirection is enabled.||0|
|Authentication level||Determines what should happen when server authentication fails. Corresponds to the selection in the If server authentication fails drop-down list on the Advanced tab under Options in RDC. There are four valid options: 0 (Connect and don’t warn me), 1 (Do not connect), 2 (Warn me), and 3 (server authentication is not required).||3|
|Autoreconnection enabled||Determines whether the client computer will automatically try to reconnect to the remote computer if the connection drops; Corresponds to the Reconnect if the connection is dropped check box on the Experience tab under Options in RDC. There are 2 valid option: 0 (do not attempt reconnect) and 1 (attempt reconnect).||1|
|Autoreconnect max retries||Determines the maximum number of times the client computer will try to reconnect to the remote computer if the connection drops||20|
|Bitmapcachepersistenable||Determines whether bitmaps are cached on the local computer. There are two valid options: 0 (do not cache) and 1 (cache).||1|
|Compression||Determines whether the connection should use bulk compression. There are two valid options: 0 (do not compress) and 1 (compress).||1|
|Desktopheight||Determines the resolution height (in pixels) on the remote computer. Corresponds to the selection in the Display configuration slider on the Display tab under Options in RDC.||N/A|
|Desktopwidth||Determines the resolution height (in pixels) on the remote computer. Corresponds to the selection in the Display configuration slider on the Display tab under Options in RDC.||N/A|
|Devicestoredirect||Specifies the devices to redirect to the remote session. Corresponds to the selections for Other supported Plug and Play (PnP) devices under More on the Local Resources tab under Options in RDC. There are four valid options: nothing (which redirects nothing), *, which redirects all devices, Dynamic Devices, whch redirects all devices added during the session, and the HW ID of the device, which will redirect only that device.||nothing|
|Disable ctrl+alt+del||This may sound like a security setting, but it determines whether the CTRL+ALT+DELETE security attention sequence is required to enter credentials after you are connected to the remote computer. Valid options include 0 (it’s not required) and 1 (it is required).||0|
|Disableprinterredirection||Determines whether Easy Print is enabled when connecting to the remote computer. Valid options include 0 (enable Easy Print) and 1 (disable Easy Print).||0|
|Disableclipboardredirection||Determines whether clipboard redirection is enabled when connecting to the remote computer. Valid options include 0 (enable clipboard) and 1 (disable clipboard).||1|
|Displayconnectionbar||Determines whether the connection bar appears when you are in full screen mode when you connect to a remote computer. Corresponds to the Display the connection bar when I use the full screen check box on the Display tab under Options in RDC. Valid options include 0 (do not display the bar) and 1 (display the bar).||1|
|Domain||Sspecifies the name of the domain for the user account that will be used to log on to the remote computer. This value and the username value appear in the RDC GUI on the General tab.||N/A|
|Enablecredsspsupport||Determines whether RDC will use CredSSP for authentication if it’s available, Valid options include 0 (don’t use CredSSP, even if available) and 1 (use CredSSP if possible).||1|
|Full address||Specifies the name of the farm or server the RDP file points to. This value can be overridden by the value of alternate full address.||The DNS name of the farm or server (e.g., farm.ash.com) or the IPv4 or IPv6 address.|
|gatewaycredentialssource||Specifies the credentials that should be used to validate the connection. Values may be 0 (ask for password, uses NTLM), 1 (use smart card), or 4 (allow user to choose).||0|
|gatewayhostname||Specifies the name of the RD Gateway.||DNS name of the RD Gateway|
|gatewayprofileusagemethod||Determines the RD Gateway authentication method a user can use, whether the defaults are specified by the administrator (0) or user-specified (1).||1|
|gatewayusagemethod||Specifies if and how RD Gateway is used. Valid options include 0 (Do not use RD Gateway), 1 (Always use the RD Gateway, even for local connections), 2 (Use the RD Gateway if a direct connection cannot be made to the terminal server), 3 (Use the default RD Gateway settings), and 4 (Do not use RD Gateway). 0 and 4 have the same effect; the only difference is in the user interface (UI), wherein the option to bypass RD Gateway is selected or cleared.||0|
|Keyboardhook||Determines how Windows key combinations are applied when you are connected to a remote computer. Corresponds to the selection in the Keyboard drop-down list on the Local Resources tab under Options in RDC. Valid options include 0 (apply them to local computer), 1 (apply them to remote computer), and 2 (apply them to the remote computer only when the remote session is in full-screen mode).||2|
|Load balance info||Specifies the provider name, endpoint type, and an endpoint. This setting is how a RD Connection Broker knows which type of resource plugin (VM or session) to activate.||N/A|
|Negotiate security layer||Determines whether the level of security is negotiated or not. If it is, then the connection begins with SSL; if I is, then the connection begins with an x.224 connection request. Valid options include 0 (use SSL) and 1 (negotiate).||1|
|Pinconnectionbar||Determines whether or not the connection bar should be pinned to the top of the remote session. Valid options include 0 (do not pin) and 1 (pin).||1|
|Prompt for credentials on client||Determines whether the connection will prompt for credentials when connecting to a server that does not support server authentication. Corresponds to the Always Ask for Credentials option in the RDP file. Valid options include 0 (do not prompt) and 1 (ask for credentials).||0|
|Redirectclipboard||Enables Remote Clipboard, which is required for copying and pasting text between local and remote settings. Valid options include 0 (do not redirect) and 1 (redirect)||1|
|Redirectcomports||Redirect COM ports to the remote session. Valid options include 0 (do not redirect) and 1 (redirect)||0|
|Redirectdrives||Specifies whether drives are redirected.||0|
|Redirectprinters||Redirects printers to the remote session. determines whether printers configured on the client computer will be redirected and available in the remote session when you connect to a remote computer. Corresponds to the selection in the Printers check box on the Local Resources tab under Options in RDC. Valid options include 0 (do not redirect) and 1 (redirect)||1|
|redirectposdevices:i:||Redirects Point of Sale Devices. Valid options include 0 (do nor redirect) and 1 (redirect).||0|
|Redirectsmartcards||Enables smart cards to use smart cards for single sign-on. Valid options include 0 (do not redirect) and 1 (redirect).||0|
|remoteapplicationcmdline||Command-line parameters for a RemoteApp (e.g, opening a file when launching the RemoteApp).||No default; provide the parameters.|
|remoteapplicationmode||Specifies that the RDP file will display a RemoteApp.||0|
|remoteapplicationname:s:||Specifies the name of the TS RemoteApp as displayed in TS Web Access or at connection time. Use this if changing the name from the default.||New name of the RemoteApp program, if you’re changing it from the default.|
|remoteapplicationprogram||Specifies the alias of the RemoteApp; don’t change it or you may prevent the RemoteApp from working with RD Web Access.||:%path%\%appname%|
|Screen mode ID||Determines whether the remote session window appears full screen when you connect to the remote computer. Valid options include 1 (display in a window ) and 2 (display full screen).||2|
|Server port||Specifies the server port the
connection request will be sent to. Use this setting if you have changed the default port on the server.
|Session bpp||Specifies the color depth to use (in bits). Valid options include15 (high color, 16 (high color) , 24 (true color) and 32 (highest quality).||32|
|Smart sizing||Determines whether the client computer should scale the content on the remote computer to fit the window size of the client computer. Valid options include 0 (don’t scale the client window) and 1 (scale the client window).||0|
|Span monitors||Enables monitor spanning. When using RDC 7, the Use multimon setting is recommended.||0|
|Username||Specifies the name of the user account that will be used to log on to the remote computer.
This value appears in the User name box on the General tab under Options in RDC
|Use multimon||Detetmines whether the session should use true multimon to connect to the endpoint. Valid options include 0 (do not use) and 1 (use)||0|
|Videoplaybackmode||Determines whether RDC will use RDP efficient multimedia streaming for video playback (in other words, send it to the client for rendering in Windows Media Player or render it on the server). Valid options include 0 (do not use) and 1 (use if available).||1|
|Winposstr||Defines the position of an RDP window on the client computer.||6 integers to define its x axis,y axis, front and back position (also known as its z order), and the window height and width.|
|Workspace id||Defines the RemoteApp and Desktop ID associated with the RDP file that contains this setting. Applies only when launched from RemoteApp and Desktop Connections.||RemoteApp and Desktop ID.|