Použití Azure CLI a Azure PowerShellu s Azure Virtual Desktopem

K dispozici je rozšíření Azure CLI a modul Azure PowerShellu pro Azure Virtual Desktop, které můžete použít k vytváření, aktualizaci, odstraňování a interakci s objekty služby Azure Virtual Desktop jako alternativy k používání webu Azure Portal. Jsou součástí Azure CLI a Azure PowerShellu, které pokrývají širokou škálu služeb Azure.

Tento článek vysvětluje, jak můžete použít rozšíření Azure CLI a modul Azure PowerShellu a několik užitečných ukázkových příkazů.

Rozšíření Azure CLI a modul Azure PowerShellu

Tady jsou názvy rozšíření Azure CLI a modulu Azure PowerShellu a odkazy na naši referenční dokumentaci:

• Azure CLI: az desktopvirtualization

• Azure PowerShell: Az.DesktopVirtualization

Azure CLI i Azure PowerShell jsou k dispozici pro použití v Azure Cloud Shellu nativně na webu Azure Portal bez instalace nebo je můžete nainstalovat místně na zařízení pro Windows, macOS a Linux.

Informace o instalaci Azure CLI a Azure PowerShellu na všech podporovaných platformách najdete na následujících odkazech:

• Azure CLI: Postup instalace Azure CLI

• Azure PowerShell: Instalace modulu Azure Az PowerShell

Příklady příkazů

Tady je několik ukázkových příkazů, které můžete použít k získání informací a hodnot o prostředcích Služby Azure Virtual Desktop, které můžou být užitečné. Vyberte příslušnou kartu pro váš scénář.

Azure CLI

Důležité

V následujících příkladech budete muset změnit <placeholder> hodnoty pro vlastní.

Dostupné oblasti Azure

Při vytváření objektů služby Azure Virtual Desktop pomocí některého z příkazů rozhraní příkazového řádku, které obsahují create, musíte zadat oblast Azure, ve které je chcete vytvořit. Pokud chcete najít název oblasti Azure, kterou chcete použít s parametrem --location , spusťte následující příkaz a použijte hodnotu ze Location sloupce:

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

Načtení ID objektu fondu hostitelů, pracovního prostoru, skupiny aplikací nebo aplikace

• Pokud chcete načíst ID objektu fondu hostitelů, spusťte následující příkaz:

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

• Pokud chcete načíst ID objektu pracovního prostoru, spusťte následující příkaz:

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

• Pokud chcete načíst ID objektu skupiny aplikací, spusťte následující příkaz:

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

Tip

Rozšíření Azure CLI pro Azure Virtual Desktop nemá příkazy pro aplikace. Místo toho použijte Azure PowerShell.

Azure PowerShell

Důležité

V následujících příkladech budete muset změnit <placeholder> hodnoty pro vlastní.

Dostupné oblasti Azure

Při vytváření objektů služby Azure Virtual Desktop pomocí některé z rutin PowerShellu, které začínají New-AzWvd..., je potřeba zadat oblast Azure, ve které je chcete vytvořit. Pokud chcete najít název oblasti Azure, kterou chcete použít s parametrem -Location , spusťte následující příkaz a použijte hodnotu ze Location sloupce:

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

Načtení ID objektu fondu hostitelů, pracovního prostoru, skupiny aplikací nebo aplikace

Některé rutiny PowerShellu vyžadují zadání ID objektu objektů služby Azure Virtual Desktop. Několik příkladů:

• Pokud chcete načíst ID objektu fondu hostitelů, spusťte následující příkaz:

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

• Pokud chcete načíst ID objektu pracovního prostoru, spusťte následující příkaz:

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

• Pokud chcete načíst ID objektu skupiny aplikací, spusťte následující příkaz:

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

• Pokud chcete načíst ID objektu desktopové aplikace, spusťte následující příkaz:

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

• Pokud chcete načíst ID objektů všech aplikací RemoteApp ve skupině aplikací, spusťte následující příkaz:

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

Další kroky

Teď, když víte, jak používat Azure CLI a Azure PowerShell se službou Azure Virtual Desktop, tady jsou některé články, které je používají:

• Vytvoření fondu hostitelů služby Azure Virtual Desktop v PowerShellu nebo Azure CLI
• Správa skupin aplikací pomocí PowerShellu nebo Azure CLI
• Úplnou referenční dokumentaci k PowerShellu najdete v tématu Az.DesktopVirtualization.