远程桌面 URI 方案
本文档定义了远程桌面的统一资源标识符 (URI) 的格式。 通过这些 URI 方案,可使用各种命令调用远程桌面客户端。
ms-rd URI 方案
注意
ms-rd URI 方案当前仅支持用于 Windows 桌面客户端 (MSRDC)。
通过 ms-rd URI,可按以下格式为客户端指定一个命名并指定一组该命令特定的参数:
ms-rd:command?parameters
参数采用查询字符串格式“键=值对”(用 & 分隔)为给定命令提供额外的信息:
param1=value1¶m2=value2&…
命令和参数
下面列表中是当前支持的命令及其相应的参数。
使用不带任何命令的 ms-rd:
启动客户端。
Subscribe
此命令会启动客户端和订阅过程。
命令名称: subscribe
命令参数:
参数 | 说明 | 值 |
---|---|---|
url | 指定工作区 URL。 | 有效的 URL,例如 https://contoso.com。 |
示例: ms-rd:subscribe?url=https://contoso.com
旧的 rdp URI 方案
注意
以下 URI 方案仅支持用于 macOS、iOS 和 Android 设备的客户端。 它将被上述新的 ms-rd URI 取代。
Microsoft 远程桌面使用 URI 方案 rdp://query_string 来存储启动客户端时使用的预配置的特性设置。 查询字符串表示 URL 中提供的单个实例或一组 RDP 特性。
RDP 属性用与号 (&) 分隔。 例如,连接到 PC 时,该字符串是:
rdp://full%20address=s:mypc:3389&audiomode=i:2&disable%20themes=i:1
此表提供可以与 iOS、Mac 和 Android 远程桌面客户端一起使用的受支持特性的完整列表。 (平台列中的“x”指示该特性受支持。 通过尖括号 (<>) 指示的值表示远程桌面客户端支持的值。)
RDP 特性 | Android | Mac | iOS |
---|---|---|---|
allow desktop composition=i:<0 或 1> | x | x | x |
allow font smoothing=i:<0 or 1> | x | x | x |
alternate shell=s:<字符串> | x | x | x |
audiomode=i:<0、1 或 2> | x | x | x |
authentication level=i:<0 或 1> | x | x | x |
connect to console=i:<0 或 1> | x | x | x |
disable cursor settings=i:<0 或 1> | x | x | x |
disable full window drag=i:<0 或 1> | x | x | x |
disable menu anims=i:<0 或 1> | x | x | x |
disable themes=i:<0 或 1> | x | x | x |
disable wallpaper=i:<0 或 1> | x | x | x |
drivestoredirect=s:* (这是唯一受支持的值) | x | x | |
desktopheight=i:<以像素为单位的值> | x | ||
desktopwidth=i:<以像素为单位的值> | x | ||
domain=s:<字符串> | x | x | x |
full address=s:<字符串> | x | x | x |
gatewayhostname=s:<字符串> | x | x | x |
gatewayusagemethod=i:<1 或 2> | x | x | x |
prompt for credentials on client=i:<0 或 1> | x | ||
loadbalanceinfo=s:<字符串> | x | x | x |
redirectprinters=i:<0 或 1> | x | ||
remoteapplicationcmdline=s:<字符串> | x | x | x |
remoteapplicationmode=i:<0 或 1> | x | x | x |
remoteapplicationprogram=s:<字符串> | x | x | x |
shell working directory=s:<字符串> | x | x | x |
Use redirection server name=i:<0 或 1> | x | x | x |
username=s:<字符串> | x | x | x |
screen mode id=i:<1 或 2> | x | ||
session bpp=i:<8、15、16、24 或 32> | x | ||
use multimon=i:<0 或 1> | x |