使用適用於 Azure 虛擬桌面的遠端桌面用戶端的統一資源識別碼配置

您可以使用統一資源識別碼（URI）配置來叫用具有特定命令、參數和值的遠端桌面用戶端，以搭配 Azure 虛擬桌面使用。例如，您可以訂閱工作區或連線到特定桌面或 RemoteApp。

本文詳細說明可用的命令和參數，以及一些範例。

支援的用戶端

下表列出支援的用戶端，以搭配 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 工作階段，並將指定的使用者直接連線至該資源。

命令名稱： 連線

命令參數：

參數	值	描述
workspaceid	對象識別碼（GUID）。	指定有效工作區的物件識別碼。若要使用PowerShell取得物件識別碼值，請參閱擷取主機集區、工作區、應用程式群組或應用程式的物件標識碼。您也可以使用桌面虛擬化 REST API。
resourceid	對象識別碼（GUID）。	指定工作區中包含的已發行資源物件標識碼。此值可以是桌面或 RemoteApp。若要使用PowerShell取得物件識別碼值，請參閱擷取主機集區、工作區、應用程式群組或應用程式的物件標識碼。您也可以使用桌面虛擬化 REST API。
使用者	使用者主體名稱（UPN），例如 `user@contoso.com`。	指定具有指定資源存取權的有效使用者。
env （選擇性）	avdarm （商業 Azure） avdgov （Azure Government）	指定資源所在的 Azure 雲端。
version	0	指定要使用的連線 URI 配置版本。
launchpartnerid （選擇性）	Guid。	指定可與 Azure 虛擬桌面診斷搭配使用的合作夥伴或客戶提供的識別碼，以協助進行疑難解答。建議您使用 GUID，您可以使用 New-Guid PowerShell Cmdlet 來產生該 GUID 。
peeractivityid （選擇性）	Guid。	指定可與 Azure 虛擬桌面診斷搭配使用的合作夥伴或客戶提供的識別碼，以協助進行疑難解答。建議您使用 GUID，您可以使用 New-Guid PowerShell Cmdlet 來產生該 GUID 。

範例：

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.microsoft.com。	指定工作區 URL。

範例：

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

以下是 URI 設定的已知限制：

瞭解如何使用適用於 Windows 的遠端桌面用戶端連線至 Azure 虛擬桌面。