大网数据广告活动
远程桌面与会话

Remote Desktop URI scheme

· 52CE 我爱测

Learn about the Uniform Resource Identifier scheme for Remote Desktop clients

This document defines the format of Uniform Resource Identifiers (URIs) for Remote Desktop. These URI schemes allow for Remote Desktop clients to be invoked with various commands.

ms-rd URI scheme

Note: The ms-rd URI scheme is currently only supported with the Windows Desktop client (MSRDC).

The ms-rd URI provides the option to specify a command for the client and a set of parameters specific to the command using the following format:

ms-rd:command?parameters

Parameters uses the query string format of key=value pair separated by & to provide additional information for the given command:

param1=value1&param2=value2&…

Commands and parameters

Here's the list of currently supported commands and their corresponding parameters.

Using ms-rd: without any commands launches the client.

Subscribe

This command launches the client and starts the subscription process.

Command name: subscribe

Command parameters:

Parameter Description Values
url Specifies the Workspace URL. A valid URL, such as https://contoso.com>`.

Example: ms-rd:subscribe?url=https://contoso.com

Legacy rdp URI scheme

Note: The following URI scheme is only supported with the clients for macOS, iOS, and Android devices.

Microsoft Remote Desktop uses the URI scheme rdp://query_string to store preconfigured 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 can 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 the Remote Desktop client supports.)

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 or 1> x x x
connect to console=i:<0 or 1> x x x
desktopheight=i:<value in pixels> x
desktopwidth=i:<value in pixels> x
disable cursor settings=i:<0 or 1> 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
domain=s:<string> x x x
drivestoredirect=s:* (this is the only supported value) 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
prompt for credentials on client=i:<0 or 1> 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
screen mode id=i:<1 or 2> x
session bpp=i:<8, 15, 16, 24, or 32> x
shell working directory=s:<string> x x x
use multimon=i:<0 or 1> x
use redirection server name=i:<0 or 1> x x x
username=s:<string> x x x

Source: Microsoft Learn / Windows Server documentation by Microsoft and contributors (upstream author metadata: robinharwood). Documentation licensed CC BY 4.0. Code samples are covered by the MIT License. Converted from Markdown, with links normalized and embedded media omitted.

资料来源与适用范围

资料来源
Microsoft Learn / Windows Server documentation
适用范围
Windows Server · Source date 7/3/2024
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY 4.0 (documentation), MIT (code samples)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。