Usare l'interfaccia della riga di comando di Azure e Azure PowerShell con Desktop virtuale Azure

È disponibile un'estensione dell'interfaccia della riga di comando di Azure e un modulo di Azure PowerShell per Desktop virtuale Azure che è possibile usare per creare, aggiornare, eliminare e interagire con gli oggetti del servizio Desktop virtuale Azure come alternative all'uso del portale di Azure. Fanno parte dell'interfaccia della riga di comando di Azure e di Azure PowerShell, che coprono un'ampia gamma di servizi di Azure.

Questo articolo illustra come usare l'estensione dell'interfaccia della riga di comando di Azure e un modulo di Azure PowerShell e fornisce alcuni comandi di esempio utili.

Estensione dell'interfaccia della riga di comando di Azure e modulo di Azure PowerShell

Ecco i nomi dell'estensione dell'interfaccia della riga di comando di Azure e del modulo Azure PowerShell e i collegamenti alla documentazione di riferimento:

• Interfaccia della riga di comando di Azure: az desktopvirtualization

• Azure PowerShell: Az.DesktopVirtualization

Sia l'interfaccia della riga di comando di Azure che Azure PowerShell sono disponibili per l'uso in Azure Cloud Shell in modo nativo nel portale di Azure senza alcuna installazione oppure è possibile installarli localmente nel dispositivo per Windows, macOS e Linux.

Per informazioni su come installare l'interfaccia della riga di comando di Azure e Azure PowerShell in tutte le piattaforme supportate, vedere i collegamenti seguenti:

• Interfaccia della riga di comando di Azure: Come installare l'interfaccia della riga di comando di Azure

• Azure PowerShell: installare il modulo Azure Az PowerShell

Comandi di esempio

Ecco alcuni comandi di esempio che è possibile usare per ottenere informazioni e valori sulle risorse di Desktop virtuale Azure che potrebbero risultare utili. Selezionare la scheda pertinente per lo scenario.

Interfaccia della riga di comando di Azure

Importante

Negli esempi seguenti è necessario modificare i <placeholder> valori personalizzati.

Aree di Azure disponibili

Quando si creano oggetti servizio Desktop virtuale Azure usando uno dei comandi dell'interfaccia della riga di comando che contengono create, è necessario specificare l'area di Azure in cui si vuole crearli. Per trovare il nome dell'area di Azure da usare con il parametro --location, eseguire il comando seguente e usare un valore dalla Location colonna:

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

Recuperare l'ID oggetto di un pool di host, un'area di lavoro, un gruppo di applicazioni o un'applicazione

• Per recuperare l'ID oggetto di un pool di host, eseguire il comando seguente:

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

• Per recuperare l'ID oggetto di un'area di lavoro, eseguire il comando seguente:

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

• Per recuperare l'ID oggetto di un gruppo di applicazioni, eseguire il comando seguente:

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

Suggerimento

L'estensione dell'interfaccia della riga di comando di Azure per Desktop virtuale Azure non include comandi per le applicazioni. Usare Azure PowerShell anziché Bicep.

Azure PowerShell

Importante

Negli esempi seguenti è necessario modificare i <placeholder> valori personalizzati.

Aree di Azure disponibili

Quando si creano oggetti servizio Desktop virtuale Azure usando uno dei cmdlet di PowerShell che iniziano New-AzWvd..., è necessario specificare l'area di Azure in cui si vuole crearli. Per trovare il nome dell'area di Azure da usare con il parametro -Location, eseguire il comando seguente e usare un valore dalla Location colonna:

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

Recuperare l'ID oggetto di un pool di host, un'area di lavoro, un gruppo di applicazioni o un'applicazione

Alcuni cmdlet di PowerShell richiedono di specificare l'ID oggetto degli oggetti del servizio Desktop virtuale Azure. Di seguito sono riportati alcuni esempi.

• Per recuperare l'ID oggetto di un pool di host, eseguire il comando seguente:

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

• Per recuperare l'ID oggetto di un'area di lavoro, eseguire il comando seguente:

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

• Per recuperare l'ID oggetto di un gruppo di applicazioni, eseguire il comando seguente:

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

• Per recuperare l'ID oggetto di un'applicazione desktop, eseguire il comando seguente:

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

• Per recuperare gli ID oggetto di tutte le applicazioni RemoteApp in un gruppo di applicazioni, eseguire il comando seguente:

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

Passaggi successivi

Dopo aver appreso come usare l'interfaccia della riga di comando di Azure e Azure PowerShell con Desktop virtuale Azure, ecco alcuni articoli che li usano:

• Creare un pool di host di Desktop virtuale Azure con PowerShell o l'interfaccia della riga di comando di Azure
• Gestire i gruppi di applicazioni usando PowerShell o l'interfaccia della riga di comando di Azure
• Per la documentazione di riferimento completa di PowerShell, vedere Az.DesktopVirtualization.