Verwenden der Azure CLI und von Azure PowerShell mit Azure Virtual Desktop

Es gibt eine Azure CLI-Erweiterung und ein Azure PowerShell-Modul für Azure Virtual Desktop, die Sie als Alternative zum Azure-Portal zum Erstellen, Aktualisieren, Löschen und Interagieren von bzw. mit Azure Virtual Desktop-Dienstobjekten nutzen können. Sie sind Teil der Azure CLI und von Azure PowerShell, die eine breite Palette 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 er enthält einige nützliche Beispielbefehle.

Azure CLI-Erweiterung und Azure PowerShell-Modul

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

• Azure-Befehlszeilenschnittstelle: az desktopvirtualization

• Azure PowerShell: Az.DesktopVirtualization

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

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

• Azure CLI: Installieren der Azure-Befehlszeilenschnittstelle

• Azure PowerShell: Installieren des Azure Az PowerShell-Moduls

Beispielbefehle

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

Azure-Befehlszeilenschnittstelle

Wichtig

In den folgenden Beispielen müssen Sie die <placeholder>-Werte durch Ihre eigenen Werte ersetzen.

Verfügbare Azure-Regionen

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

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 durch Ihre eigenen Werte ersetzen.

Verfügbare Azure-Regionen

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

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

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

Bei einigen PowerShell-Cmdlets müssen Sie die Objekt-ID der Azure Virtual Desktop-Dienstobjekte angeben. Hier 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

Sie wissen nun, wie Sie die Azure CLI und Azure PowerShell mit Azure Virtual Desktop nutzen. Im Anschluss finden Sie einige Artikel, in denen sie verwendet werden:

• 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.