共用方式為


與 Azure 虛擬桌面遠端桌面用戶端的統一資源識別碼方案

您可以使用統一資源識別碼 (URI) 方案,呼叫遠端桌面用戶端,並指定特定指令、參數與值,供虛擬桌面Azure使用。 例如,你可以訂閱工作區,或連接特定的桌面或 RemoteApp。

本文詳細說明可用的指令與參數,並附有一些範例。

支援的用戶端

下表列出可用於 URI 方案的支援用戶端:

用戶端 版本
Windows 遠端桌面用戶端 1.2.4065 及以後版本
Windows 版 Windows App
僅限MS-AVD
2.0.804.0 及以後版本

可用的 URI 方案

支援的遠端桌面用戶端有兩種 URI 方案,分別是 ms-avdms-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

指令參數:

參數 描述
工作空間ID 物件 ID (GUID) 。 指定有效工作區的物件 ID。

要使用 PowerShell 取得物件 ID 值,請參見 「取得主機池、工作空間、應用程式群組或應用程式的物件 ID」。 你也可以使用 桌面虛擬化的 REST API

遠端桌面用戶端的必備功能
Windows App 不支援
resourceid 物件 ID (GUID) 。 指定工作區中已發佈資源的物件 ID。 這個價值可以是桌面或 RemoteApp。

要使用 PowerShell 取得物件 ID 值,請參見 「取得主機池、工作空間、應用程式群組或應用程式的物件 ID」。 你也可以使用 桌面虛擬化的 REST API

遠端桌面用戶端與 Windows App 必須具備
使用者 使用者 user@contoso.com主體名稱 (UPN) 。 指定一位有效使用者,擁有指定資源的存取權。

遠端桌面用戶端與 Windows App 必須具備
環境 Avdarm (商業Azure)
美國政府 (Azure Government)
指定資源所在的 Azure 雲端。

遠端桌面用戶端的可選功能
Windows App 不支援。
版本 0 指定要使用的 connect URI 方案版本。

遠端桌面用戶端的必備功能
Windows App 不支援。
發射夥伴 GUID。 請指定合作夥伴或客戶提供的 ID,以便 Azure 虛擬桌面診斷協助故障排除。 我們建議使用 GUID,你可以用 New-Guid PowerShell 指令檔產生。

遠端桌面用戶端的可選功能
Windows App 不支援。
PeerActivityID GUID。 請指定合作夥伴或客戶提供的 ID,以便 Azure 虛擬桌面診斷協助故障排除。 我們建議使用 GUID,你可以用 New-Guid PowerShell 指令檔產生。

遠端桌面用戶端的可選功能
Windows App 不支援。
用多重獸 指定遠端會話是使用本地電腦的一個或多個顯示器。

遠端桌面用戶端與 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:訂閱

ms-rd:subscribe 啟動遠端桌面用戶端並開始訂閱流程。

指令名稱: subscribe

指令參數:

參數 描述
URL 一個有效的 URL,例如 https://rdweb.wvd.microsoft.com 請指定一個工作區網址。

範例:

ms-rd:subscribe?url=https://rdweb.wvd.microsoft.com

已知限制

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

  • 顯示屬性無法透過 URI 來設定。 你可以在主機池中以管理員身份設定顯示屬性,或是終端使用者在 Azure 虛擬桌面用戶端中設定顯示屬性。

後續步驟

學習如何使用 Windows 遠端桌面用戶端連接 Azure 虛擬桌面