Azure CLI en Azure PowerShell gebruiken met Azure Virtual Desktop

Er is een Azure CLI-extensie en een Azure PowerShell-module voor Azure Virtual Desktop die u kunt gebruiken om Azure Virtual Desktop-serviceobjecten te maken, bij te werken, te verwijderen en te gebruiken als alternatief voor het gebruik van de Azure Portal. Ze maken deel uit van Azure CLI en Azure PowerShell, die een breed scala aan Azure-services omvatten.

In dit artikel wordt uitgelegd hoe u de Azure CLI-extensie en een Azure PowerShell-module kunt gebruiken, en vindt u enkele nuttige voorbeeldopdrachten.

Azure CLI-extensie en Azure PowerShell-module

Hier volgen de namen van de Azure CLI-extensie en Azure PowerShell-module, en koppelingen naar onze referentiedocumentatie:

• Azure CLI: az desktopvirtualization

• Azure PowerShell:Az.DesktopVirtualization

Zowel Azure CLI als Azure PowerShell zijn beschikbaar voor gebruik in de Azure Cloud Shell systeemeigen in de Azure Portal zonder installatie, of u kunt ze lokaal installeren op uw apparaat voor Windows, macOS en Linux.

Zie de volgende koppelingen voor meer informatie over het installeren van Azure CLI en Azure PowerShell op alle ondersteunde platforms:

• Azure CLI: De Azure CLI installeren

• Azure PowerShell: De Azure Az PowerShell-module installeren

Voorbeeldopdrachten

Hier volgen enkele voorbeelden van opdrachten die u kunt gebruiken om informatie en waarden op te halen over uw Azure Virtual Desktop-resources die u mogelijk nuttig vindt. Selecteer het relevante tabblad voor uw scenario.

Azure CLI

Belangrijk

In de volgende voorbeelden moet u de <placeholder> waarden zelf wijzigen.

Beschikbare Azure-regio's

Wanneer u Azure Virtual Desktop-serviceobjecten maakt met behulp van een van de CLI-opdrachten die bevatten create, moet u de Azure-regio opgeven waarin u ze wilt maken. Als u de naam wilt vinden van de Azure-regio die moet worden gebruikt met de --location parameter, voert u de volgende opdracht uit en gebruikt u een waarde uit de Location kolom:

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

De object-id van een hostgroep, werkruimte, toepassingsgroep of toepassing ophalen

• Voer de volgende opdracht uit om de object-id van een hostgroep op te halen:

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

• Voer de volgende opdracht uit om de object-id van een werkruimte op te halen:

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

• Voer de volgende opdracht uit om de object-id van een toepassingsgroep op te halen:

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

Tip

De Azure CLI-extensie voor Azure Virtual Desktop heeft geen opdrachten voor toepassingen. Gebruik in plaats hiervan Azure PowerShell.

Azure PowerShell

Belangrijk

In de volgende voorbeelden moet u de <placeholder> waarden zelf wijzigen.

Beschikbare Azure-regio's

Wanneer u Azure Virtual Desktop-serviceobjecten maakt met behulp van een van de PowerShell-cmdlets die beginnen New-AzWvd..., moet u de Azure-regio opgeven waarin u ze wilt maken. Als u de naam wilt vinden van de Azure-regio die moet worden gebruikt met de -Location parameter, voert u de volgende opdracht uit en gebruikt u een waarde uit de Location kolom:

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

De object-id van een hostgroep, werkruimte, toepassingsgroep of toepassing ophalen

Voor sommige PowerShell-cmdlets moet u de object-id van Azure Virtual Desktop-serviceobjecten opgeven. Dit zijn enkele voorbeelden:

• Voer de volgende opdracht uit om de object-id van een hostgroep op te halen:

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

• Voer de volgende opdracht uit om de object-id van een werkruimte op te halen:

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

• Voer de volgende opdracht uit om de object-id van een toepassingsgroep op te halen:

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

• Voer de volgende opdracht uit om de object-id van een bureaubladtoepassing op te halen:

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

• Voer de volgende opdracht uit om de object-id's van alle RemoteApp-toepassingen in een toepassingsgroep op te halen:

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

Volgende stappen

Nu u weet hoe u Azure CLI en Azure PowerShell gebruikt met Azure Virtual Desktop, volgen hier enkele artikelen waarin ze worden gebruikt:

• Een Azure Virtual Desktop-hostgroep maken met PowerShell of de Azure CLI
• Toepassingsgroepen beheren met PowerShell of de Azure CLI
• Zie Az.DesktopVirtualization voor de volledige PowerShell-referentiedocumentatie.