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. Ambas son alternativas al uso de 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 se proporcionan 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 del módulo de Azure PowerShell, y los 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 Azure Portal sin necesidad de instalarlos, o bien puede instalarlos localmente en el dispositivo para Windows, macOS y Linux.

Para aprende a instalar la CLI de Azure y Azure PowerShell en todas las plataformas compatibles, consulte los vínculos siguientes:

• CLI de Azure: Procedimiento para instalar la CLI de Azure

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

Comandos de ejemplo

Estos son algunos comandos de ejemplo que se puede usar para obtener información y los valores de los recursos de Azure Virtual Desktop que le pueden puede resultar útiles. Seleccione la pestaña correspondiente a su escenario.

CLI de Azure

Importante

En los siguientes ejemplos, deberá cambiar los valores de <placeholder> por los suyos.

Regiones de Azure disponibles

Al crear objetos de servicio de Azure Virtual Desktop mediante cualquiera de los comandos de la CLI que contengan 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 parámetro --location, ejecute el siguiente comando y use un valor de la columna Location:

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

Recuperación 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 aplicaciones. Use Azure PowerShell en su lugar.

Azure PowerShell

Importante

En los siguientes ejemplos, deberá cambiar los valores de <placeholder> por los suyos.

Regiones de Azure disponibles

Al crear objetos de servicio de Azure Virtual Desktop mediante cualquiera de los cmdlets de PowerShell que comienzan por 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 parámetro -Location, ejecute el siguiente comando y use un valor de la columna Location:

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

Recuperación 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 de 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
• Administrar grupos de aplicaciones mediante PowerShell o la CLI de Azure
• Para obtener la documentación de referencia completa de PowerShell, consulte Az.DesktopVirtualization.