Utilizar a CLI do Azure e o Azure PowerShell com o Azure Virtual Desktop

Existe uma extensão da CLI do Azure e um módulo de Azure PowerShell para o Azure Virtual Desktop que pode utilizar para criar, atualizar, eliminar e interagir com objetos de serviço do Azure Virtual Desktop como alternativa à utilização do portal do Azure. Fazem parte da CLI do Azure e do Azure PowerShell, que abrangem uma vasta gama de serviços do Azure.

Este artigo explica como pode utilizar a extensão da CLI do Azure e um módulo Azure PowerShell e fornece alguns comandos de exemplo úteis.

Extensão e módulo de Azure PowerShell da CLI do Azure

Eis os nomes da extensão da CLI do Azure e Azure PowerShell módulo e ligações para a nossa documentação de referência:

• CLI do Azure: az desktopvirtualization

• Azure PowerShell:Az.DesktopVirtualization

Tanto a CLI do Azure como as Azure PowerShell estão disponíveis para utilização no Azure Cloud Shell nativamente no portal do Azure sem instalação ou pode instalá-las localmente no seu dispositivo para Windows, macOS e Linux.

Para saber como instalar a CLI do Azure e Azure PowerShell em todas as plataformas suportadas, veja as seguintes ligações:

• CLI do Azure: Como instalar a CLI do Azure

• Azure PowerShell: Instalar o módulo do Azure Az PowerShell

Comandos de exemplo

Eis alguns comandos de exemplo que pode utilizar para obter informações e valores sobre os recursos do Azure Virtual Desktop que poderá considerar úteis. Selecione o separador relevante para o seu cenário.

CLI do Azure

Importante

Nos exemplos seguintes, terá de alterar os <placeholder> valores dos seus próprios valores.

Regiões do Azure disponíveis

Ao criar objetos de serviço do Azure Virtual Desktop com qualquer um dos comandos da CLI que contenham create, tem de especificar a região do Azure na qual pretende criá-los. Para localizar o nome da região do Azure a utilizar com o --location parâmetro , execute o seguinte comando e utilize um valor da Location coluna:

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

Obter o ID de objeto de um conjunto de anfitriões, área de trabalho, grupo de aplicações ou aplicação

• Para obter o ID de objeto de um conjunto de anfitriões, execute o seguinte comando:

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

• Para obter o ID de objeto de uma área de trabalho, execute o seguinte comando:

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

• Para obter o ID de objeto de um grupo de aplicações, execute o seguinte comando:

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

Dica

A extensão da CLI do Azure para o Azure Virtual Desktop não tem comandos para aplicações. Em alternativa, utilize Azure PowerShell.

Azure PowerShell

Importante

Nos exemplos seguintes, terá de alterar os <placeholder> valores dos seus próprios valores.

Regiões do Azure disponíveis

Ao criar objetos de serviço do Azure Virtual Desktop com qualquer um dos cmdlets do PowerShell que começam New-AzWvd..., tem de especificar a região do Azure na qual pretende criá-los. Para localizar o nome da região do Azure a utilizar com o -Location parâmetro , execute o seguinte comando e utilize um valor da Location coluna:

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

Obter o ID de objeto de um conjunto de anfitriões, área de trabalho, grupo de aplicações ou aplicação

Alguns cmdlets do PowerShell requerem que forneça o ID de objeto dos objetos de serviço do Azure Virtual Desktop. Aqui estão alguns exemplos:

• Para obter o ID de objeto de um conjunto de anfitriões, execute o seguinte comando:

  (Get-AzWvdHostPool -Name <HostPoolName> -ResourceGroupName <ResourceGroupName>).ObjectId
  

• Para obter o ID de objeto de uma área de trabalho, execute o seguinte comando:

  (Get-AzWvdWorkspace -Name <WorkspaceName> -ResourceGroupName <ResourceGroupName>).ObjectID
  

• Para obter o ID de objeto de um grupo de aplicações, execute o seguinte comando:

  (Get-AzWvdApplicationGroup -Name <ApplicationGroupName> -ResourceGroupName <ResourceGroupName>).ObjectId
  

• Para obter o ID de objeto de uma aplicação de ambiente de trabalho, execute o seguinte comando:

  (Get-AzWvdDesktop -Name <DesktopName> -ApplicationGroupName <ApplicationGroupName> -ResourceGroupName <ResourceGroupName>).ObjectId
  

• Para obter os IDs de objeto de todas as aplicações RemoteApp num grupo de aplicações, execute o seguinte comando:

  Get-AzWvdApplication -ApplicationGroupName <ApplicationGroupName> -ResourceGroupName <ResourceGroupName> | Select-Object Name, FilePath, ObjectId
  

Próximas etapas

Agora que sabe como utilizar a CLI do Azure e Azure PowerShell com o Azure Virtual Desktop, eis alguns artigos que os utilizam:

• Criar um conjunto de anfitriões do Azure Virtual Desktop com o PowerShell ou a CLI do Azure
• Gerir grupos de aplicações com o PowerShell ou a CLI do Azure
• Para obter a documentação de referência completa do PowerShell, veja Az.DesktopVirtualization.