Verwenden der Azure CLI und Azure PowerShell mit Azure Virtual Desktop

Es gibt eine Azure CLI-Erweiterung und ein Azure PowerShell-Modul für Azure Virtual Desktop, mit denen Sie Azure Virtual Desktop-Dienstobjekte erstellen, aktualisieren, löschen und mit ihnen interagieren können, als Alternative zur Verwendung des Azure-Portal. Sie sind Teil der Azure CLI und Azure PowerShell, die eine Vielzahl von Azure-Diensten abdecken.

In diesem Artikel wird erläutert, wie Sie die Azure CLI-Erweiterung und ein Azure PowerShell-Modul verwenden können, und enthält einige nützliche Beispielbefehle.

Azure CLI-Erweiterung und Azure PowerShell-Modul

Hier finden Sie die Namen der Azure CLI-Erweiterung und Azure PowerShell Moduls sowie Links zu unserer Referenzdokumentation:

• Azure CLI: az desktopvirtualization

• Azure PowerShell:Az.DesktopVirtualization

Sowohl die Azure CLI als auch Azure PowerShell können im Azure-Cloud Shell nativ im Azure-Portal ohne Installation verwendet werden, oder Sie können sie lokal auf Ihrem Gerät für Windows, macOS und Linux installieren.

Informationen zum Installieren der Azure CLI und Azure PowerShell auf allen unterstützten Plattformen finden Sie unter den folgenden Links:

• Azure CLI: Installieren der Azure CLI

• Azure PowerShell: Installieren des Azure Az PowerShell-Moduls

Beispielbefehle

Im Folgenden finden Sie einige Beispielbefehle, mit denen Sie Informationen und Werte zu Ihren Azure Virtual Desktop-Ressourcen abrufen können, die Sie möglicherweise hilfreich finden. Wählen Sie die relevante Registerkarte für Ihr Szenario aus.

Azure CLI

Wichtig

In den folgenden Beispielen müssen Sie die <placeholder> Werte für Ihre eigenen ändern.

Verfügbare Azure-Regionen

Beim Erstellen von Azure Virtual Desktop-Dienstobjekten mit einem der CLI-Befehle, die enthalten create, müssen Sie die Azure-Region angeben, in der Sie sie erstellen möchten. Um den Namen der Azure-Region zu ermitteln, die mit dem --location Parameter verwendet werden soll, führen Sie den folgenden Befehl aus, und verwenden Sie einen Wert aus der Location Spalte:

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

Abrufen der Objekt-ID eines Hostpools, Arbeitsbereichs, einer Anwendungsgruppe oder einer Anwendung

• Führen Sie den folgenden Befehl aus, um die Objekt-ID eines Hostpools abzurufen:

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

• Führen Sie den folgenden Befehl aus, um die Objekt-ID eines Arbeitsbereichs abzurufen:

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

• Führen Sie den folgenden Befehl aus, um die Objekt-ID einer Anwendungsgruppe abzurufen:

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

Tipp

Die Azure CLI-Erweiterung für Azure Virtual Desktop verfügt nicht über Befehle für Anwendungen. Verwenden Sie stattdessen Azure PowerShell.

Azure PowerShell

Wichtig

In den folgenden Beispielen müssen Sie die <placeholder> Werte für Ihre eigenen ändern.

Verfügbare Azure-Regionen

Beim Erstellen von Azure Virtual Desktop-Dienstobjekten mit einem der PowerShell-Cmdlets, die beginnen New-AzWvd..., müssen Sie die Azure-Region angeben, in der Sie sie erstellen möchten. Um den Namen der Azure-Region zu ermitteln, die mit dem -Location Parameter verwendet werden soll, führen Sie den folgenden Befehl aus, und verwenden Sie einen Wert aus der Location Spalte:

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

Abrufen der Objekt-ID eines Hostpools, Arbeitsbereichs, einer Anwendungsgruppe oder einer Anwendung

Für einige PowerShell-Cmdlets müssen Sie die Objekt-ID der Azure Virtual Desktop-Dienstobjekte angeben. Hier sind einige Beispiele:

• Führen Sie den folgenden Befehl aus, um die Objekt-ID eines Hostpools abzurufen:

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

• Führen Sie den folgenden Befehl aus, um die Objekt-ID eines Arbeitsbereichs abzurufen:

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

• Führen Sie den folgenden Befehl aus, um die Objekt-ID einer Anwendungsgruppe abzurufen:

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

• Führen Sie den folgenden Befehl aus, um die Objekt-ID einer Desktopanwendung abzurufen:

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

• Führen Sie den folgenden Befehl aus, um die Objekt-IDs aller RemoteApp-Anwendungen in einer Anwendungsgruppe abzurufen:

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

Nächste Schritte

Nachdem Sie nun wissen, wie Sie azure CLI und Azure PowerShell mit Azure Virtual Desktop verwenden, finden Sie hier einige Artikel, die sie verwenden:

• Erstellen eines Azure Virtual Desktop-Hostpools mit PowerShell oder der Azure CLI
• Verwalten von Anwendungsgruppen mithilfe von PowerShell oder der Azure CLI
• Die vollständige PowerShell-Referenzdokumentation finden Sie unter Az.DesktopVirtualization.