Универсальные схемы идентификаторов ресурсов с клиентом удаленного рабочего стола для виртуального рабочего стола Azure
Схемы универсального идентификатора ресурса (URI) можно использовать для вызова клиента удаленного рабочего стола с определенными командами, параметрами и значениями для использования с виртуальным рабочим столом Azure. Например, вы можете подписаться на рабочую область или подключиться к конкретному рабочему столу или RemoteApp.
В этой статье описаны доступные команды и параметры, а также некоторые примеры.
Поддерживаемые клиенты
В следующей таблице перечислены поддерживаемые клиенты для использования со схемами URI:
| Клиент | Версия |
|---|---|
| Клиент удаленного рабочего стола для Windows | 1.2.4065 и более поздних версий |
Доступные схемы URI
Существует две схемы URI для поддерживаемых клиентов удаленного рабочего стола, ms-avd и ms-rd. С помощью ms-avd можно указать определенный ресурс виртуального рабочего стола Azure и пользователя, с которым нужно подключиться. С помощью ms-rd вы можете автоматически подписаться на рабочую область в клиенте удаленного рабочего стола, а не добавлять рабочую область вручную.
В следующих разделах подробно описаны команды и параметры, которые можно использовать с каждой схемой URI.
ms-avd
Схема универсального идентификатора ресурса ms-avd для виртуального рабочего стола Azure теперь общедоступна. Ниже приведен список поддерживаемых в настоящее время команд для ms-avd и соответствующих параметров.
ms-avd:connect
ms-avd:connect находит указанный ресурс Виртуального рабочего стола Azure и инициирует сеанс RDP, напрямую подключая указанного пользователя к нему.
Имя команды: подключение
Параметры команды:
| Параметр | Значения | Description |
|---|---|---|
| WorkspaceID | Идентификатор объекта (GUID). | Укажите идентификатор объекта допустимой рабочей области. Чтобы получить значение идентификатора объекта с помощью PowerShell, ознакомьтесь с идентификатором объекта пула узлов, рабочей области, группы приложений или приложения. Вы также можете использовать REST API виртуализации рабочих столов. |
| resourceid | Идентификатор объекта (GUID). | Укажите идентификатор объекта опубликованного ресурса, содержащегося в рабочей области. Значение может быть для рабочего стола или RemoteApp. Чтобы получить значение идентификатора объекта с помощью PowerShell, ознакомьтесь с идентификатором объекта пула узлов, рабочей области, группы приложений или приложения. Вы также можете использовать REST API виртуализации рабочих столов. |
| Пользователь | Имя участника-пользователя (UPN), например user@contoso.com. |
Укажите допустимого пользователя с доступом к указанному ресурсу. |
| env (необязательно) | avdarm (коммерческая среда Azure) avdgov (Azure для государственных организаций) |
Укажите облако Azure, где находятся ресурсы. |
| версия | 0 | Укажите версию схемы URI подключения для использования. |
| launchpartnerid (необязательно) | GUID. | Укажите идентификатор партнера или клиента, который можно использовать с диагностикой виртуального рабочего стола Azure для устранения неполадок. Рекомендуется использовать GUID, который можно создать с помощью командлета New-Guid PowerShell. |
| peeractivityid (необязательно) | GUID. | Укажите идентификатор партнера или клиента, который можно использовать с диагностикой виртуального рабочего стола Azure для устранения неполадок. Рекомендуется использовать GUID, который можно создать с помощью командлета New-Guid PowerShell. |
Пример:
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
Параметры команды:
| Параметр | Значения | Description |
|---|---|---|
| URL-адрес | Допустимый URL-адрес, например https://rdweb.wvd.microsoft.com. | Укажите URL-адрес рабочей области. |
Пример:
ms-rd:subscribe?url=https://rdweb.wvd.microsoft.com
Известные ограничения
Ниже приведены известные ограничения для схем URI:
- Свойства отображения нельзя настроить с помощью URI. Вы можете настроить свойства отображения в качестве администратора в пуле узлов или конечных пользователей, чтобы настроить свойства отображения в клиенте Виртуального рабочего стола Azure.
Следующие шаги
Узнайте, как Подключение виртуальному рабочему столу Azure с помощью клиента удаленного рабочего стола для Windows.