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

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

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

支持的客户端

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

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

可用 URI 方案

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

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

ms-avd

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

ms-avd:connect

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 生成它。
usemultimon truefalse 指定远程会话是否使用本地计算机的一个或多个显示器。

示例:

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: 会启动远程桌面客户端。

ms-rd:subscribe

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 方案的已知限制:

后续步骤

了解如何使用适用于 Windows 的远程桌面客户端连接到 Azure 虚拟桌面