使用適用於 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 工作階段，進而直接將指定的使用者連線到該資源。

命令名稱：connect

命令參數：

參數	值	描述
WorkspaceID	物件識別碼 (GUID)。	指定有效工作區的物件識別碼。若要使用 PowerShell 取得物件識別碼值，請參閱擷取主機集區、工作區、應用程式群組或應用程式的物件識別碼。您也可使用桌面虛擬化 REST API。
resourceid	物件識別碼 (GUID)。	指定工作區中內含的已發佈資源的物件識別碼。此值可以是桌面或 RemoteApp。若要使用 PowerShell 取得物件識別碼值，請參閱擷取主機集區、工作區、應用程式群組或應用程式的物件識別碼。您也可使用桌面虛擬化 REST API。
使用者	使用者主體名稱 (UPN)，例如 `user@contoso.com`。	指定具有指定資源存取權的有效使用者。
env (選用)	avdarm (商業 Azure) usgov （Azure Government）	指定資源所在的 Azure 雲端。
version	0	指定要使用的連線 URI 配置版本。
launchpartnerid (選用)	GUID。	指定您可搭配 Azure 虛擬桌面診斷使用的合作夥伴或客戶提供的識別碼，協助進行疑難排解。建議您使用 GUID，您可使用 New-Guid PowerShell Cmdlet 來產生此 GUID。
peeractivityid (選用)	GUID。	指定您可搭配 Azure 虛擬桌面診斷使用的合作夥伴或客戶提供的識別碼，協助進行疑難排解。建議您使用 GUID，您可使用 New-Guid PowerShell Cmdlet 來產生此 GUID。
usemultimon	[True] 或 [False]	指定遠端會話是否會使用本機計算機的一或多個顯示器。

範例：

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:subscribe 可啟動遠端桌面用戶端並啟動訂用帳戶程序。

命令名稱：subscribe

命令參數：

參數	值	描述
URL	有效的 URL，例如 https://rdweb.wvd.microsoft.com。	指定工作區 URL。

範例：

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

以下是 URI 配置的已知限制：