Använda Azure CLI och Azure PowerShell med Azure Virtual Desktop

Det finns ett Azure CLI-tillägg och en Azure PowerShell-modul för Azure Virtual Desktop som du kan använda för att skapa, uppdatera, ta bort och interagera med Azure Virtual Desktop-tjänstobjekt som alternativ till att använda Azure-portalen. De ingår i Azure CLI och Azure PowerShell, som omfattar ett brett utbud av Azure-tjänster.

Den här artikeln beskriver hur du kan använda Azure CLI-tillägget och en Azure PowerShell-modul och innehåller några användbara exempelkommandon.

Azure CLI-tillägget och Azure PowerShell-modulen

Här är namnen på Azure CLI-tillägget och Azure PowerShell-modulen och länkar till vår referensdokumentation:

• Azure CLI: az desktopvirtualization

• Azure PowerShell: Az.DesktopVirtualization

Både Azure CLI och Azure PowerShell är tillgängliga för användning i Azure Cloud Shell internt i Azure-portalen utan installation, eller så kan du installera dem lokalt på enheten för Windows, macOS och Linux.

Information om hur du installerar Azure CLI och Azure PowerShell på alla plattformar som stöds finns i följande länkar:

• Azure CLI: Så här installerar du Azure CLI

• Azure PowerShell: Installera Azure Az PowerShell-modulen

Exempelkommandon

Här följer några exempelkommandon som du kan använda för att hämta information och värden om dina Azure Virtual Desktop-resurser som du kanske tycker är användbara. Välj relevant flik för ditt scenario.

Azure CLI

Viktigt

I följande exempel måste du ändra <placeholder> värdena för dina egna.

Tillgängliga Azure-regioner

När du skapar Azure Virtual Desktop-tjänstobjekt med något av CLI-kommandona som innehåller createmåste du ange den Azure-region som du vill skapa dem i. Om du vill hitta namnet på den Azure-region som ska användas med parametern --location kör du följande kommando och använder ett värde från Location kolumnen:

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

Hämta objekt-ID för en värdpool, arbetsyta, programgrupp eller program

• Kör följande kommando för att hämta objekt-ID:t för en värdpool:

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

• Kör följande kommando för att hämta objekt-ID:t för en arbetsyta:

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

• Kör följande kommando för att hämta objekt-ID:t för en programgrupp:

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

Tips

Azure CLI-tillägget för Azure Virtual Desktop har inte kommandon för program. Använd Azure PowerShell i stället.

Azure PowerShell

Viktigt

I följande exempel måste du ändra <placeholder> värdena för dina egna.

Tillgängliga Azure-regioner

När du skapar Azure Virtual Desktop-tjänstobjekt med någon av de PowerShell-cmdletar som börjar New-AzWvd...måste du ange den Azure-region som du vill skapa dem i. Om du vill hitta namnet på den Azure-region som ska användas med parametern -Location kör du följande kommando och använder ett värde från Location kolumnen:

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

Hämta objekt-ID för en värdpool, arbetsyta, programgrupp eller program

Vissa PowerShell-cmdletar kräver att du anger objekt-ID för Azure Virtual Desktop-tjänstobjekt. Nedan följer några exempel:

• Kör följande kommando för att hämta objekt-ID:t för en värdpool:

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

• Kör följande kommando för att hämta objekt-ID:t för en arbetsyta:

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

• Kör följande kommando för att hämta objekt-ID:t för en programgrupp:

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

• Kör följande kommando för att hämta objekt-ID:t för ett skrivbordsprogram:

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

• Kör följande kommando för att hämta objekt-ID:t för alla RemoteApp-program i en programgrupp:

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

Nästa steg

Nu när du vet hur du använder Azure CLI och Azure PowerShell med Azure Virtual Desktop finns här några artiklar som använder dem:

• Skapa en Azure Virtual Desktop-värdpool med PowerShell eller Azure CLI
• Hantera programgrupper med Hjälp av PowerShell eller Azure CLI
• Den fullständiga PowerShell-referensdokumentationen finns i Az.DesktopVirtualization.