Export (0) Print
Expand All

Remote Desktop Client URI Scheme Support

Updated: August 12, 2014

Applies To: Windows 8.1, Windows Server 2012 R2



Enabling a Uniform Resource Identifier (URI) scheme gives IT professionals and developers a way to integrate features of the Remote Desktop clients across platforms and enriches the user experience by allowing:

  1. Third-party applications to launch Microsoft Remote Desktop and start remote sessions with predefined settings (provided as part of the URI string).

  2. End users to start remote connections using pre-configured URLs.

Microsoft Remote Desktop uses the URI scheme rdp://query_string to store pre-configured attribute settings that are used when launching the client. The query strings represent a single or set of RDP attributes provided in the URL. The RDP attributes are separated by the ampersand symbol (&).

For example, when connecting to a PC, the string is:

rdp://full%20address=s:mypc:3389&audiomode=i:2&disable%20themes=i:1

This table gives a complete list of supported attributes that may be used with the iOS, Mac, and Android Remote Desktop clients. (An “x” in the platform column indicates the attribute is supported. The values denoted by chevrons (<>) represent the values that are supported by the Remote Desktop clients.)

 

RDP Attribute Android Mac iOS

allow desktop composition=i:<0 or 1>

x

x

x

allow font smoothing=i:<0 or 1>

x

x

x

alternate shell=s:<string>

x

x

x

audiomode=i:<0, 1, or 2>

x

x

x

authentication level=i:<0, 1, or 2>

x

x

x

connect to console=i:<0 or 1>

x

x

x

disable cursor settings=i:<0 or1>

x

x

x

disable full window drag=i:<0 or 1>

x

x

x

disable menu anims=i:<0 or 1>

x

x

x

disable themes=i:<0 or 1>

x

x

x

disable wallpaper=i:<0 or 1>

x

x

x

drivestoredirect=s:<string>

x

x

desktopheight=i:<value in pixels>

x

desktopwidth=i:<value in pixels>

x

domain=s:<string>

x

x

x

full address=s:<string>

x

x

x

gatewayhostname=s:<string>

x

x

x

gatewayusagemethod=i:<1 or 2>

x

x

x

loadbalanceinfo=s:<string>

x

x

x

redirectprinters=i:<0 or 1>

x

remoteapplicationcmdline=s:<string>

x

x

x

remoteapplicationmode=i:<0 or 1>

x

x

x

remoteapplicationprogram=s:<string>

x

x

x

shell working directory=s:<string>

x

x

x

userdirectionservername=s:<string>

x

x

x

username=s:<string>

x

x

x

screen mode id=i:<1 or 2>

x

session bpp=i:<8, 15, 16, 24, or 32>

x

use multimon=i:<0 or 1>

x

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft