Использование Azure CLI и Azure PowerShell с Виртуальным рабочим столом Azure

2025-06-20

Существует расширение Azure CLI и модуль Azure PowerShell для Виртуального рабочего стола Azure, который можно использовать для создания, обновления, удаления объектов службы Виртуального рабочего стола Azure и взаимодействия с ними в качестве альтернативы использованию портал Azure. Они входят в состав Azure CLI и Azure PowerShell, которые охватывают широкий спектр служб Azure.

В этой статье объясняется, как использовать расширение Azure CLI и модуль Azure PowerShell, а также приведены некоторые полезные примеры команд.

Модуль расширения Azure CLI и Azure PowerShell

Ниже приведены имена расширения Azure CLI и модуля Azure PowerShell, а также ссылки на нашу справочную документацию:

Azure CLI: az desktopvirtualization
Azure PowerShell:Az.DesktopVirtualization

Azure CLI и Azure PowerShell доступны для использования в Azure Cloud Shell в портал Azure без установки, либо их можно установить локально на устройстве для Windows, macOS и Linux.

Сведения об установке Azure CLI и Azure PowerShell на всех поддерживаемых платформах см. по следующим ссылкам:

Azure CLI: установка Azure CLI
Azure PowerShell: установка модуля Azure Az PowerShell

Примеры команд

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

Azure CLI
Azure PowerShell

Важно!

В следующих примерах необходимо изменить <placeholder> значения для собственных.

Доступные регионы Azure

При создании объектов службы Виртуального рабочего стола Azure с помощью любой из команд CLI, содержащих create, необходимо указать регион Azure, в котором они будут созданы. Чтобы найти имя региона Azure для использования с параметром --location , выполните следующую команду и используйте значение из столбца Location :

az account list-locations --query "sort_by([].{DisplayName:displayName, Location:name}, &Location)" -o table

Получение идентификатора объекта пула узлов, рабочей области, группы приложений или приложения

Чтобы получить идентификатор объекта пула узлов, выполните следующую команду:

az desktopvirtualization hostpool show \
     --name <Name> \
     --resource-group <ResourceGroupName> \
     --query objectId 
     --output tsv

Чтобы получить идентификатор объекта рабочей области, выполните следующую команду:
```
az desktopvirtualization workspace show \
     --name <Name> \
     --resource-group <ResourceGroupName> \
     --query objectId 
     --output tsv
```
Чтобы получить идентификатор объекта группы приложений, выполните следующую команду:
```
az desktopvirtualization applicationgroup show \
     --name <Name> \
     --resource-group <ResourceGroupName> \
     --query objectId 
     --output tsv
```

Совет

Расширение Azure CLI для Виртуального рабочего стола Azure не содержит команд для приложений. Вместо этого используйте Azure PowerShell.

Важно!

В следующих примерах необходимо изменить <placeholder> значения для собственных.

Доступные регионы Azure

При создании объектов службы Виртуального рабочего стола Azure с помощью любого из командлетов PowerShell, которые начинаются New-AzWvd..., необходимо указать регион Azure, в который вы хотите их создать. Чтобы найти имя региона Azure для использования с параметром -Location , выполните следующую команду и используйте значение из столбца Location :

Get-AzLocation | Sort-Object DisplayName | FT DisplayName, Location

Получение идентификатора объекта пула узлов, рабочей области, группы приложений или приложения

Некоторые командлеты PowerShell требуют предоставления идентификатора объектов службы Виртуального рабочего стола Azure. Ниже приводятся примеры:

Чтобы получить идентификатор объекта пула узлов, выполните следующую команду:
```
(Get-AzWvdHostPool -Name <HostPoolName> -ResourceGroupName <ResourceGroupName>).ObjectId
```
Чтобы получить идентификатор объекта рабочей области, выполните следующую команду:
```
(Get-AzWvdWorkspace -Name <WorkspaceName> -ResourceGroupName <ResourceGroupName>).ObjectID
```
Чтобы получить идентификатор объекта группы приложений, выполните следующую команду:
```
(Get-AzWvdApplicationGroup -Name <ApplicationGroupName> -ResourceGroupName <ResourceGroupName>).ObjectId
```
Чтобы получить идентификатор объекта классического приложения, выполните следующую команду:
```
(Get-AzWvdDesktop -Name <DesktopName> -ApplicationGroupName <ApplicationGroupName> -ResourceGroupName <ResourceGroupName>).ObjectId
```
Чтобы получить идентификаторы объектов всех приложений RemoteApp в группе приложений, выполните следующую команду:
```
Get-AzWvdApplication -ApplicationGroupName <ApplicationGroupName> -ResourceGroupName <ResourceGroupName> | Select-Object Name, FilePath, ObjectId
```

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

Теперь, когда вы знаете, как использовать Azure CLI и Azure PowerShell с Виртуальным рабочим столом Azure, вот несколько статей, в которых они используются:

Создание пула узлов Виртуального рабочего стола Azure с помощью PowerShell или Azure CLI
Управление группами приложений с помощью PowerShell или Azure CLI
Полную справочную документацию по PowerShell см. в разделе Az.DesktopVirtualization.

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

Использование Azure CLI и Azure PowerShell с Виртуальным рабочим столом Azure

Модуль расширения Azure CLI и Azure PowerShell

Примеры команд

Доступные регионы Azure

Получение идентификатора объекта пула узлов, рабочей области, группы приложений или приложения

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

Обратная связь

Дополнительные ресурсы