Azure 虚拟桌面的远程桌面客户端的统一资源标识符方案

可以使用统一资源标识符 (URI) 方案调用远程桌面客户端，并将特定命令、参数和值用于 Azure 虚拟桌面。例如，可以订阅工作区或连接到特定的桌面或远程应用。

本文详细介绍了可用的命令和参数，以及一些示例。

支持的客户端

下表列出了用于 URI 方案的受支持客户端：

客户端	版本
适用于 Windows 的远程桌面客户端	1.2.4065 及更高版本

受支持的远程桌面客户端有两种 URI 方案：ms-avd 和 ms-rd。使用 ms-avd 时，可以指定要连接的特定 Azure 虚拟桌面资源和用户。使用 ms-rd 时，可以在远程桌面客户端中自动订阅工作区，而不必手动添加工作区。

以下部分详细介绍了可用于每个 URI 方案的命令和参数。

Azure 虚拟桌面的 ms-avd 统一资源标识符方案现已正式发布。此列表包含 ms-avd 当前支持的命令及其相应的参数。

ms-avd:connect 会找到指定的 Azure 虚拟桌面资源并启动 RDP 会话，直接将指定用户连接到该资源。

命令名称：connect

命令参数：

参数	值	说明
workspaceid	对象 ID (GUID)。	指定有效工作区的对象 ID。若要使用 PowerShell 获取对象 ID 值，请参阅检索主机池、工作区、应用程序组或应用程序的对象 ID。还可以使用桌面虚拟化 REST API。
resourceid	对象 ID (GUID)。	指定工作区中包含的已发布资源的对象 ID。该值可以是用于桌面或远程应用。若要使用 PowerShell 获取对象 ID 值，请参阅检索主机池、工作区、应用程序组或应用程序的对象 ID。还可以使用桌面虚拟化 REST API。
user	用户主体名称 (UPN)，例如 `user@contoso.com`。	指定有权访问指定资源的有效用户。
env （可选）	avdarm（商业 Azure） avdgov（Azure 政府）	指定资源所在的 Azure 云。
版本	0	指定要使用的连接 URI 方案的版本。
launchpartnerid （可选）	GUID。	指定合作伙伴或客户提供的 ID，可将其用于 Azure 虚拟桌面诊断以帮助进行故障排除。建议使用 GUID，可以使用 New-Guid PowerShell cmdlet 生成它。
peeractivityid （可选）	GUID。	指定合作伙伴或客户提供的 ID，可将其用于 Azure 虚拟桌面诊断以帮助进行故障排除。建议使用 GUID，可以使用 New-Guid PowerShell cmdlet 生成它。

示例：

ms-avd:connect?workspaceId=1638e073-63b2-46d8-bd84-ea02ea905467&resourceid=c2f5facc-196f-46af-991e-a90f3252c185&username=user@contoso.com&version=0

此列表包含 ms-rd 当前支持的命令及其相应的参数。

提示

使用不带任何命令的 ms-rd: 会启动远程桌面客户端。

ms-rd:subscribe 会启动远程桌面客户端和订阅过程。

命令名称： subscribe

命令参数：

参数	值	描述
url	有效的 URL，例如 https://rdweb.wvd.azure.cn/api/arm/feeddiscovery。	指定工作区 URL。

示例：

ms-rd:subscribe?url=https://rdweb.wvd.azure.cn/api/arm/feeddiscovery

以下是 URI 方案的已知限制：