Поделиться через


Схемы универсального идентификатора ресурсов с помощью клиента удаленного рабочего стола для Azure виртуального рабочего стола

Схемы универсального кода ресурса (URI) можно использовать для вызова клиента удаленного рабочего стола с определенными командами, параметрами и значениями для использования с Azure Виртуальным рабочим столом. Например, можно подписаться на рабочую область или подключиться к определенному рабочему столу или RemoteApp.

В этой статье подробно описаны доступные команды и параметры, а также некоторые примеры.

Поддерживаемые клиенты

В следующей таблице перечислены поддерживаемые клиенты для использования со схемами URI:

Клиент Версия
Клиент удаленного рабочего стола для Windows 1.2.4065 и более поздних версий
Windows App для Windows
Только ms-avd
2.0.804.0 и более поздних версий

Доступные схемы URI

Существует две схемы URI для поддерживаемых клиентов удаленного рабочего стола: ms-avd и ms-rd. С помощью ms-avd можно указать конкретный ресурс виртуального рабочего стола Azure и пользователя, с которым нужно подключиться. С помощью ms-rd можно автоматически подписаться на рабочую область в клиенте удаленного рабочего стола, а не добавлять рабочую область вручную.

В следующих разделах подробно описаны команды и параметры, которые можно использовать с каждой схемой URI.

ms-avd

Схема универсального идентификатора ресурсов ms-avd для виртуального рабочего стола Azure теперь общедоступна. Ниже приведен список поддерживаемых в настоящее время команд для ms-avd и их соответствующих параметров.

Важно!

Если на устройстве установлен клиент удаленного рабочего стола и Windows App версии 2.0.804.0 или более поздней, протокол ms-avd запустит Windows App.

ms-avd:connect

ms-avd:connectнаходит указанный ресурс Azure виртуального рабочего стола и инициирует сеанс RDP, напрямую подключая указанного пользователя к нему.

Имя команды: connect

Параметры команды:

Параметр Значения Описание
workspaceid Идентификатор объекта (GUID). Укажите идентификатор объекта допустимой рабочей области.

Сведения о том, как получить значение идентификатора объекта с помощью PowerShell, см. в статье Получение идентификатора объекта пула узлов, рабочей области, группы приложений или приложения. Вы также можете использовать REST API виртуализации рабочих столов.

Требуется в клиенте удаленного рабочего стола
Не поддерживается в Windows App
resourceid Идентификатор объекта (GUID). Укажите идентификатор объекта опубликованного ресурса, содержащегося в рабочей области. Значение может быть для рабочего стола или RemoteApp.

Сведения о том, как получить значение идентификатора объекта с помощью PowerShell, см. в статье Получение идентификатора объекта пула узлов, рабочей области, группы приложений или приложения. Вы также можете использовать REST API виртуализации рабочих столов.

Требуется в клиенте удаленного рабочего стола и Windows App
пользователь Имя участника-пользователя (UPN), например user@contoso.com. Укажите допустимого пользователя с доступом к указанному ресурсу.

Требуется в клиенте удаленного рабочего стола и Windows App
env avdarm (коммерческая Azure)
usgov (Azure для государственных организаций)
Укажите Azure облако, в котором находятся ресурсы.

Необязательно в клиенте удаленного рабочего стола
Не поддерживается в Windows App.
version 0 Укажите версию схемы URI подключения для использования.

Требуется в клиенте удаленного рабочего стола
Не поддерживается в Windows App.
launchpartnerid GUID. Укажите предоставленный партнером или клиентом идентификатор, который можно использовать с Azure диагностики виртуального рабочего стола, чтобы помочь в устранении неполадок. Рекомендуется использовать ИДЕНТИФИКАТОР GUID, который можно создать с помощью командлета PowerShell New-Guid .

Необязательно в клиенте удаленного рабочего стола
Не поддерживается в Windows App.
peeractivityid GUID. Укажите предоставленный партнером или клиентом идентификатор, который можно использовать с Azure диагностики виртуального рабочего стола, чтобы помочь в устранении неполадок. Рекомендуется использовать ИДЕНТИФИКАТОР GUID, который можно создать с помощью командлета PowerShell New-Guid .

Необязательно в клиенте удаленного рабочего стола
Не поддерживается в Windows App.
usemultimon true или false Укажите, будет ли удаленный сеанс использовать один или несколько дисплеев с локального компьютера.

Необязательно в клиенте удаленного рабочего стола и 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:subscribe

ms-rd:subscribe запускает клиент удаленного рабочего стола и запускает процесс подписки.

Имя команды: подписка

Параметры команды:

Параметр Значения Описание
url Допустимый URL-адрес, например https://rdweb.wvd.microsoft.com. Укажите URL-адрес рабочей области.

Пример:

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

Известные ограничения

Ниже приведены известные ограничения схем URI:

Дальнейшие действия

Узнайте, как подключиться к виртуальному рабочему столу Azure с помощью клиента удаленного рабочего стола для Windows.