你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
可以使用统一资源标识符 (URI) 方案，通过特定的命令、参数和值调用远程桌面客户端，以便与 Azure 虚拟桌面一起使用。 例如，可以订阅工作区或连接到特定的桌面或 RemoteApp。
本文详细介绍了可用的命令和参数，以及一些示例。
支持的客户端
下表列出了与 URI 方案一起使用的受支持客户端：
| 客户端 | 版本 |
|---|---|
| 适用于 Windows 的远程桌面客户端 | 1.2.4065 及更高版本 |
|
适用于 Windows 的Windows App 仅限 ms-avd |
2.0.804.0 及更高版本 |
可用 URI 方案
支持的远程桌面客户端有两种 URI 方案： ms-avd 和 ms-rd。 使用 ms-avd，可以指定要连接的特定Azure虚拟桌面资源和用户。 使用 ms-rd，可以在远程桌面客户端中自动订阅工作区，而无需手动添加工作区。
以下部分详细介绍了可用于每个 URI 方案的命令和参数。
ms-avd
Azure虚拟桌面的 ms-avd 统一资源标识符方案现已正式发布。 下面是 ms-avd 当前支持的命令及其相应参数的列表。
重要
如果设备上同时安装了远程桌面客户端和Windows App版本 2.0.804.0 或更高版本，则 ms-avd 协议将启动Windows App。
ms-avd：connect
ms-avd:connect找到指定的Azure虚拟桌面资源并启动 RDP 会话，直接将指定的用户连接到该资源。
命令名称： connect
命令参数：
| 参数 | 值 | 说明 |
|---|---|---|
| workspaceid | 对象 ID (GUID) 。 | 指定有效工作区的对象 ID。 若要使用 PowerShell 获取对象 ID 值，请参阅 检索主机池、工作区、应用程序组或应用程序的对象 ID。 还可以使用 桌面虚拟化 REST API。 远程桌面客户端中必需 Windows App不支持 |
| resourceid | 对象 ID (GUID) 。 | 指定工作区中包含的已发布资源的对象 ID。 对于桌面或 RemoteApp，该值可以是 。 若要使用 PowerShell 获取对象 ID 值，请参阅 检索主机池、工作区、应用程序组或应用程序的对象 ID。 还可以使用 桌面虚拟化 REST API。 在远程桌面客户端和Windows App中是必需的 |
| 用户 | 用户主体名称 (UPN) ，例如 user@contoso.com。 |
指定有权访问指定资源的有效用户。 在远程桌面客户端和Windows App中是必需的 |
| env |
avdarm (商业Azure) usgov (Azure 政府) |
指定资源所在的Azure云。 远程桌面客户端中的可选 Windows App不支持。 |
| version | 0 | 指定要使用的连接 URI 方案的版本。 远程桌面客户端中必需 Windows App不支持。 |
| launchpartnerid | GUID。 | 指定合作伙伴或客户提供的 ID，可用于Azure虚拟桌面诊断以帮助进行故障排除。 建议使用 GUID，可以使用 New-Guid PowerShell cmdlet 生成该 GUID。 远程桌面客户端中的可选 Windows App不支持。 |
| peeractivityid | GUID。 | 指定合作伙伴或客户提供的 ID，可用于Azure虚拟桌面诊断以帮助进行故障排除。 建议使用 GUID，可以使用 New-Guid PowerShell cmdlet 生成该 GUID。 远程桌面客户端中的可选 Windows App不支持。 |
| usemultimon | true 或 false | 指定远程会话是使用本地计算机的一个或多个显示器。 在远程桌面客户端和Windows App中可选 |
示例：
ms-avd:connect?workspaceId=1638e073-63b2-46d8-bd84-ea02ea905467&resourceid=a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1&username=user@contoso.com&version=0
ms-rd
下面是 ms-rd 当前支持的命令及其相应参数的列表。
提示
在不使用任何命令的情况下使用 ms-rd: 将启动远程桌面客户端。
ms-rd：subscribe
ms-rd:subscribe 启动远程桌面客户端并启动订阅过程。
命令名称： 订阅
命令参数：
| 参数 | 值 | 说明 |
|---|---|---|
| url | 有效的 URL，例如 https://rdweb.wvd.microsoft.com。 | 指定工作区 URL。 |
示例：
ms-rd:subscribe?url=https://rdweb.wvd.microsoft.com
已知限制
以下是 URI 方案的已知限制：
- 无法通过 URI 配置显示属性。 可以在主机池上以管理员身份配置显示属性，最终用户可以在Azure虚拟桌面客户端中配置显示属性。