Używanie interfejsu wiersza polecenia platformy Azure i programu Azure PowerShell z usługą Azure Virtual Desktop

Istnieje rozszerzenie interfejsu wiersza polecenia platformy Azure i moduł programu 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 witryny Azure Portal. Są one częścią interfejsu wiersza polecenia platformy Azure i programu Azure PowerShell, który obejmuje szeroką gamę usług platformy Azure.

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

Rozszerzenie interfejsu wiersza polecenia platformy Azure i moduł programu Azure PowerShell

Poniżej przedstawiono 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

• Program Azure PowerShell: Az.DesktopVirtualization

Interfejs wiersza polecenia platformy Azure i program Azure PowerShell są dostępne do użycia w usłudze Azure Cloud Shell natywnie w witrynie 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 program 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 programu PowerShell

Przykładowe polecenia

Oto kilka przykładowych poleceń, których można użyć, aby uzyskać informacje i wartości dotyczące 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żne

W poniższych przykładach należy 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 createpolecenie należy określić region świadczenia usługi Azure, w którym 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 kolumny Location :

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
  

Napiwek

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

Azure PowerShell

Ważne

W poniższych przykładach należy 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 poleceń cmdlet programu PowerShell rozpoczynających się New-AzWvd...należy określić region świadczenia usługi Azure, w którym 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 kolumny Location :

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 wiesz już, jak używać interfejsu wiersza polecenia platformy Azure i programu Azure PowerShell z usługą Azure Virtual Desktop, oto kilka artykułów, które ich używają:

• 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ę referencyjną programu PowerShell, zobacz Az.DesktopVirtualization.