Azure 虚拟桌面的远程桌面客户端的统一资源标识符方案
可以使用统一资源标识符 (URI) 方案调用远程桌面客户端,并将特定命令、参数和值用于 Azure 虚拟桌面。 例如,可以订阅工作区或连接到特定的桌面或远程应用。
本文详细介绍了可用的命令和参数,以及一些示例。
支持的客户端
下表列出了用于 URI 方案的受支持客户端:
客户端 | 版本 |
---|---|
适用于 Windows 的远程桌面客户端 | 1.2.4065 及更高版本 |
可用 URI 方案
受支持的远程桌面客户端有两种 URI 方案:ms-avd 和 ms-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 | true 或 false | 指定远程会话是否使用本地计算机的一个或多个显示器。 |
示例:
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 方案的已知限制:
- 无法通过 URI 配置显示属性。 可以在主机池上以管理员身份配置显示属性,最终用户可以在 Azure 虚拟桌面客户端中配置显示属性。