Uso de la CLI de Azure y Azure PowerShell con Azure Virtual Desktop

Hay una extensión de la CLI de Azure y un módulo de Azure PowerShell para Azure Virtual Desktop que puede usar para crear, actualizar, eliminar e interactuar con objetos de servicio de Azure Virtual Desktop como alternativas al uso de la Azure Portal. Forman parte de la CLI de Azure y Azure PowerShell, que abarcan una amplia gama de servicios de Azure.

En este artículo se explica cómo puede usar la extensión de la CLI de Azure y un módulo de Azure PowerShell, y proporciona algunos comandos de ejemplo útiles.

Extensión de la CLI de Azure y módulo de Azure PowerShell

Estos son los nombres de la extensión de la CLI de Azure y el módulo de Azure PowerShell, y vínculos a nuestra documentación de referencia:

• CLI de Azure: az desktopvirtualization

• Azure PowerShell:Az.DesktopVirtualization

Tanto la CLI de Azure como Azure PowerShell están disponibles para su uso en Azure Cloud Shell de forma nativa en el Azure Portal sin instalación, o bien puede instalarlos localmente en el dispositivo para Windows, macOS y Linux.

Para obtener información sobre cómo instalar la CLI de Azure y Azure PowerShell en todas las plataformas admitidas, consulte los vínculos siguientes:

• CLI de Azure: Instalación de la CLI de Azure

• Azure PowerShell: Instalación del módulo Azure Az PowerShell

Comandos de ejemplo

Estos son algunos comandos de ejemplo que puede usar para obtener información y valores sobre los recursos de Azure Virtual Desktop que podría resultarle útil. Seleccione la pestaña correspondiente para el escenario.

Azure CLI

Importante

En los ejemplos siguientes, tendrá que cambiar los <placeholder> valores de los suyos propios.

Regiones de Azure disponibles

Al crear objetos de servicio de Azure Virtual Desktop mediante cualquiera de los comandos de la CLI que contienen create, debe especificar la región de Azure en la que desea crearlos. Para buscar el nombre de la región de Azure que se va a usar con el --location parámetro , ejecute el siguiente comando y use un valor de la Location columna:

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

Recuperar el identificador de objeto de un grupo de hosts, un área de trabajo, un grupo de aplicaciones o una aplicación

• Para recuperar el identificador de objeto de un grupo de hosts, ejecute el siguiente comando:

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

• Para recuperar el identificador de objeto de un área de trabajo, ejecute el siguiente comando:

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

• Para recuperar el identificador de objeto de un grupo de aplicaciones, ejecute el siguiente comando:

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

Sugerencia

La extensión de la CLI de Azure para Azure Virtual Desktop no tiene comandos para las aplicaciones. Use Azure PowerShell en su lugar.

Azure PowerShell

Importante

En los ejemplos siguientes, tendrá que cambiar los <placeholder> valores de los suyos propios.

Regiones de Azure disponibles

Al crear objetos de servicio de Azure Virtual Desktop mediante cualquiera de los cmdlets de PowerShell que comienzan New-AzWvd..., debe especificar la región de Azure en la que desea crearlos. Para buscar el nombre de la región de Azure que se va a usar con el -Location parámetro , ejecute el siguiente comando y use un valor de la Location columna:

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

Recuperar el identificador de objeto de un grupo de hosts, un área de trabajo, un grupo de aplicaciones o una aplicación

Algunos cmdlets de PowerShell requieren que proporcione el identificador de objeto de los objetos de servicio de Azure Virtual Desktop. Estos son algunos ejemplos:

• Para recuperar el identificador de objeto de un grupo de hosts, ejecute el siguiente comando:

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

• Para recuperar el identificador de objeto de un área de trabajo, ejecute el siguiente comando:

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

• Para recuperar el identificador de objeto de un grupo de aplicaciones, ejecute el siguiente comando:

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

• Para recuperar el identificador de objeto de una aplicación de escritorio, ejecute el siguiente comando:

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

• Para recuperar los identificadores de objeto de todas las aplicaciones RemoteApp de un grupo de aplicaciones, ejecute el siguiente comando:

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

Pasos siguientes

Ahora que sabe cómo usar la CLI de Azure y Azure PowerShell con Azure Virtual Desktop, estos son algunos artículos que los usan:

• Creación de un grupo de hosts de Azure Virtual Desktop con PowerShell o la CLI de Azure
• Administración de grupos de aplicaciones mediante PowerShell o la CLI de Azure
• Para obtener la documentación de referencia completa de PowerShell, consulte Az.DesktopVirtualization.