Supported Remote Desktop RDP file settings

Supported Remote Desktop RDP file settings

The following table includes the list of supported RDP file settings that you can use with the Remote Desktop clients. When configuring settings, check Client comparisons to see which redirections each client supports.

Setting

Type

Default value

Description and possible values

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

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

allow desktop composition

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

allow font smoothing

Determines whether font smoothing may be used in the remote session.

0 - Disable font smoothing in the remote session.
1 - Font smoothing is permitted.

0 - Disable font smoothing in the remote session.
1 - Font smoothing is permitted.

Yes

alternate full address

Determines whether a program starts automatically when you connect with RDP. This setting corresponds to the Program path and file name box on the Programs tab of the Remote Desktop Connection client. To specify an alternate shell, enter a valid path to an executable file for the value, for example ""C:\ProgramFiles\Office\word.exe"". This setting also determines the path or the alias of the Remote Application to be started at connection time if RemoteApplicationMode is enabled.

e.g., "C:\ProgramFiles\Office\word.exe"

alternate shell

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

audiocapturemode

Determines how sounds captured (recorded) on the local computer are handled when you are connected to the remote computer.

(0) Disable audio capture from the local device; (1) Enable audio capture from the local device and redirection to an audio application in the remote session

Yes

audiomode

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

audioqualitymode

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.

authentication level

Defines the server authentication level settings.

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

autoreconnect max retries

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.

autoreconnection enabled

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

bandwidthautodetect

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

bitmapcachepersistenable

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

bitmapcachesize

1500

Specifies the size in kilobytes of the memory-based bitmap cache. The maximum value is 32000.

compression

This setting determines whether bulk compression is enabled when it is transmitted by RDP to the local computer.

0 - Do not use bulk compression.
1 - Use bulk compression.

connect to console

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

connection type

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

desktopheight

600

This setting determines the resolution height (in pixels) on the remote computer when you connect by using Remote Desktop Connection (RDC). This setting corresponds to the selection in the Display configuration slider on the Display tab under Options in RDC.

Numerical value from 200 to 2048

Limited

desktop size id

Specifies dimensions of the remote session desktop from a set of pre-defined options. This setting is overridden if either desktopheight or desktopwidth are specified.

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

desktopwidth

800

This setting determines the resolution width (in pixels) on the remote computer when you connect by using Remote Desktop Connection (RDC). This setting corresponds to the selection in the Display configuration slider on the Display tab under Options in RDC.

Numerical value from 200 to 4096

Limited

devicestoredirect

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

disable ctrl+alt+del

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.

disable full window drag

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

disable menu anims

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

disable themes

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

disable wallpaper

Determines whether the desktop background is displayed in the remote session.

0 - Display the wallpaper.
1 - Do not show any wallpaper.

Yes

/[no]wallpaper

disableconnectionsharing

Determines whether the remote desktop client reconnects to any existing open connections or initiate a new connection when a RemoteApp or desktop is launched

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.

disableremoteappcapscheck

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+.

displayconnectionbar

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

domain

Specifies the name of the domain of the user.

Will be ignored/overruled by RDP+.

A valid domain name, e.g., "CONTOSO"

Yes

/u, /domain

drivestoredirect

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).

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.

Yes

/[no]drives

enablecredsspsupport

This setting determines whether RDP will use the Credential Security Support Provider (CredSSP) for authentication if it is available.

0 - Do not use CredSSP, even if the operating system supports it.
1 - Use CredSSP, if the operating system supports it.

enablesuperpan

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.

full address

This setting specifies the name or IP address of the remote computer that you want to connect to

A valid computer name, IPv4 address, or IPv6 address - Specifies the remote computer to which you want to connect.

Yes

gatewaycredentialssource

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

gatewayhostname

Specifies the hostname of the RD Gateway.

Yes

/rdgateway

gatewayprofileusagemethod

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

gatewayusagemethod

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

keyboardhook

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

negotiate security layer

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.

networkautodetect

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

password 51

The user password in a binary hash value. Will be overruled by RDP+.

Yes

/p, /pe, /i

pinconnectionbar

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.

prompt for credentials

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

prompt for credentials on client

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+.

promptcredentialonce

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

public mode

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

redirectclipboard

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

redirectcomports

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

redirectdirectx

Determines whether DirectX will be enabled for the remote session.

0 - Do not enable DirectX rendering.
1 - Enable DirectX rendering in the remote session.

redirectdrives

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

redirectposdevices

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.

redirectprinters

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

redirectsmartcards

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

remoteapplicationcmdline

Optional command line parameters for the RemoteApp.

remoteapplicationfile

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.

/remotefile

remoteapplicationexpandcmdline

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.

remoteapplicationexpandworkingdir

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.

remoteapplicationicon

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.

remoteapplicationmode

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.

/remoteapp

remoteapplicationname

Specifies the name of the RemoteApp in the Remote Desktop interface while starting the RemoteApp.

remoteapplicationprogram

Specifies the alias or executable name of the RemoteApp.

/remoteapp

screen mode id

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[ullscreen], /fit,
/max, /w, /h

server port

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

session bpp

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

shell working directory

The working directory on the remote computer to be used if an alternate shell is specified.

Yes

smart sizing

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.

span monitors

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

superpanaccelerationfactor

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

usbdevicestoredirect

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

use multimon

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

username

Specifies the name of the user account that will be used to log on to the remote computer.

Will be ignored by RDP+.

Yes

videoplaybackmode

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.

winposstr

0,3,0,0,800,600

Specifies the position and dimensions of the session window on the client computer.

Will be overruled by RDP+.

/f[ullscreen], /fit,
/max, /w, /h, /pos

RDC versions

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.

INFORMATICS

The Best

Przełącznik języka

Tools

This Site

Mining

Security

CMS

Hardware

Backup

Windows Server

Databases

Emulators

Powershell

Storage Array

Active Directory

SEO

MSSQL

Antivirus program

Linux

Licznik

Visitor Info

Who Is Online