Korzystanie z interfejsu wiersza polecenia platformy Azure i Azure PowerShell z usługą Azure Virtual Desktop

Istnieje rozszerzenie interfejsu wiersza polecenia platformy Azure i moduł Azure PowerShell dla usługi Azure Virtual Desktop, którego można użyć do tworzenia, aktualizowania, usuwania i interakcji z obiektami usługi Azure Virtual Desktop jako alternatywy dla korzystania z Azure Portal. Są one częścią interfejsu wiersza polecenia platformy Azure i Azure PowerShell, które obejmują szeroką gamę usług platformy Azure.

W tym artykule wyjaśniono, jak można używać rozszerzenia interfejsu wiersza polecenia platformy Azure i modułu Azure PowerShell, a także przedstawiono kilka przydatnych przykładowych poleceń.

Rozszerzenie interfejsu wiersza polecenia platformy Azure i moduł Azure PowerShell

Oto nazwy rozszerzenia interfejsu wiersza polecenia platformy Azure i modułu Azure PowerShell oraz linki do naszej dokumentacji referencyjnej:

• Interfejs wiersza polecenia platformy Azure: az desktopvirtualization

• Azure PowerShell:Az.DesktopVirtualization

Interfejs wiersza polecenia platformy Azure i Azure PowerShell są dostępne do użycia w usłudze Azure Cloud Shell natywnie w Azure Portal bez instalacji lub można je zainstalować lokalnie na urządzeniu dla systemów Windows, macOS i Linux.

Aby dowiedzieć się, jak zainstalować interfejs wiersza polecenia platformy Azure i Azure PowerShell na wszystkich obsługiwanych platformach, zobacz następujące linki:

• Interfejs wiersza polecenia platformy Azure: jak zainstalować interfejs wiersza polecenia platformy Azure

• Azure PowerShell: Instalowanie modułu Azure Az PowerShell

Przykładowe polecenia

Oto kilka przykładowych poleceń, których można użyć do uzyskania informacji i wartości dotyczących zasobów usługi Azure Virtual Desktop, które mogą okazać się przydatne. Wybierz odpowiednią kartę dla danego scenariusza.

Interfejs wiersza polecenia platformy Azure

Ważna

W poniższych przykładach musisz zmienić <placeholder> własne wartości.

Dostępne regiony platformy Azure

Podczas tworzenia obiektów usługi Azure Virtual Desktop przy użyciu dowolnych poleceń interfejsu wiersza polecenia zawierających createelement należy określić region platformy Azure, w ramach którego chcesz je utworzyć. Aby znaleźć nazwę regionu platformy Azure do użycia z parametrem --location , uruchom następujące polecenie i użyj wartości z Location kolumny:

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

Pobieranie identyfikatora obiektu puli hostów, obszaru roboczego, grupy aplikacji lub aplikacji

• Aby pobrać identyfikator obiektu puli hostów, uruchom następujące polecenie:

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

• Aby pobrać identyfikator obiektu obszaru roboczego, uruchom następujące polecenie:

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

• Aby pobrać identyfikator obiektu grupy aplikacji, uruchom następujące polecenie:

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

Porada

Rozszerzenie interfejsu wiersza polecenia platformy Azure dla usługi Azure Virtual Desktop nie ma poleceń dla aplikacji. Zamiast tego użyj Azure PowerShell.

Azure PowerShell

Ważna

W poniższych przykładach musisz zmienić <placeholder> własne wartości.

Dostępne regiony platformy Azure

Podczas tworzenia obiektów usługi Azure Virtual Desktop przy użyciu dowolnego z rozpoczynających się New-AzWvd...poleceń cmdlet programu PowerShell należy określić region platformy Azure, w ramach którego chcesz je utworzyć. Aby znaleźć nazwę regionu platformy Azure do użycia z parametrem -Location , uruchom następujące polecenie i użyj wartości z Location kolumny:

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

Pobieranie identyfikatora obiektu puli hostów, obszaru roboczego, grupy aplikacji lub aplikacji

Niektóre polecenia cmdlet programu PowerShell wymagają podania identyfikatora obiektu obiektów usługi Azure Virtual Desktop. Oto kilka przykładów:

• Aby pobrać identyfikator obiektu puli hostów, uruchom następujące polecenie:

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

• Aby pobrać identyfikator obiektu obszaru roboczego, uruchom następujące polecenie:

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

• Aby pobrać identyfikator obiektu grupy aplikacji, uruchom następujące polecenie:

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

• Aby pobrać identyfikator obiektu aplikacji klasycznej, uruchom następujące polecenie:

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

• Aby pobrać identyfikatory obiektów wszystkich aplikacji RemoteApp w grupie aplikacji, uruchom następujące polecenie:

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

Następne kroki

Teraz, gdy już wiesz, jak używać interfejsu wiersza polecenia platformy Azure i Azure PowerShell z usługą Azure Virtual Desktop, oto kilka artykułów, które z nich korzystają:

• Tworzenie puli hostów usługi Azure Virtual Desktop przy użyciu programu PowerShell lub interfejsu wiersza polecenia platformy Azure
• Zarządzanie grupami aplikacji przy użyciu programu PowerShell lub interfejsu wiersza polecenia platformy Azure
• Aby uzyskać pełną dokumentację programu PowerShell, zobacz Az.DesktopVirtualization.