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 serviceobjecten van Azure Virtual Desktop te maken, bij te werken, te verwijderen en te gebruiken als alternatief voor het gebruik van Azure Portal. Ze maken deel uit van Azure CLI en Azure PowerShell, die betrekking hebben op een breed scala aan Azure-services.

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

Azure CLI-extensie en Azure PowerShell-module

Hier volgen de namen van de Azure CLI-extensie en de 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 azure Cloud Shell 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 voor uw eigen waarden wijzigen.

Beschikbare Azure-regio's

Wanneer u Azure Virtual Desktop-serviceobjecten maakt met behulp van een van de CLI-opdrachten die deze bevatten create, moet u de Azure-regio opgeven waarin u ze wilt maken. Als u de naam van de Azure-regio wilt vinden die u wilt gebruiken 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 daarvan Azure PowerShell.

Azure PowerShell

Belangrijk

In de volgende voorbeelden moet u de <placeholder> waarden voor uw eigen waarden 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 van de Azure-regio wilt vinden die u wilt gebruiken 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. Hieronder volgen een aantal 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, vindt u hier enkele artikelen die ze gebruiken:

• Maak een Azure Virtual Desktop-hostgroep met PowerShell of de Azure CLI
• Toepassingsgroepen beheren met Behulp van PowerShell of de Azure CLI
• Zie Az.DesktopVirtualization voor de volledige powerShell-referentiedocumentatie.