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

Существует расширение 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

Важно!

В следующих примерах необходимо изменить <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.

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.