您可以使用統一資源識別碼 (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
指令參數:
| 參數 | 值 | 描述 |
|---|---|---|
| 工作空間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 虛擬桌面用戶端中設定顯示屬性。