搭配 Azure 虛擬桌面使用 Azure CLI 和 Azure PowerShell

Azure 虛擬桌面有 Azure CLI 擴充功能和 Azure PowerShell 模組，可用來建立、更新、刪除及與 Azure 虛擬桌面服務對象互動，作為使用 Azure 入口網站 的替代方案。 它們是 Azure CLI 和 Azure PowerShell 的一部分，涵蓋各種 Azure 服務。

本文說明如何使用 Azure CLI 擴充功能和 Azure PowerShell 模組，並提供一些有用的範例命令。

Azure CLI 擴充功能和 Azure PowerShell 模組

以下是 Azure CLI 擴充功能和 Azure PowerShell 模組的名稱，以及參考文件的連結：

• Azure CLI： az desktopvirtualization

• Azure PowerShell：Az.DesktopVirtualization

Azure CLI 和 Azure PowerShell 都可在 Azure Cloud Shell 原生方式在不安裝的 Azure 入口網站 中使用，或者您可以在 Windows、macOS 和 Linux 的裝置本機安裝它們。

若要瞭解如何跨所有支援的平臺安裝 Azure CLI 和 Azure PowerShell，請參閱下列連結：

• Azure CLI： 如何安裝 Azure CLI

• Azure PowerShell：安裝 Azure Az PowerShell 模組

範例命令

以下是一些範例命令，可用來取得您可能會覺得有用的 Azure 虛擬桌面資源相關信息和值。 選取您案例的相關索引標籤。

Azure CLI

重要事項

在下列範例中 <placeholder> ，您必須變更自己的值。

可用的 Azure 區域

使用任何包含 create的 CLI 命令建立 Azure 虛擬桌面服務物件時，您必須指定您想要在其中建立它們的 Azure 區域。 若要尋找要與 --location 參數搭配使用的 Azure 區域名稱，請執行下列命令，並使用數據行中的 Location 值：

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

擷取主機集區、工作區、應用程式群組或應用程式的物件標識碼

• 若要擷取主機集區的物件標識碼，請執行下列命令：

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

• 若要擷取工作區的物件識別碼，請執行下列命令：

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

• 若要擷取應用程式群組的物件識別碼，請執行下列命令：

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

提示

適用於 Azure 虛擬桌面的 Azure CLI 擴充功能沒有應用程式的命令。 請改用 Azure PowerShell。

Azure PowerShell

重要事項

在下列範例中 <placeholder> ，您必須變更自己的值。

可用的 Azure 區域

使用任何開始 New-AzWvd...的 PowerShell Cmdlet 建立 Azure 虛擬桌面服務物件時，您必須指定您想要在其中建立它們的 Azure 區域。 若要尋找要與 -Location 參數搭配使用的 Azure 區域名稱，請執行下列命令，並使用數據行中的 Location 值：

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

擷取主機集區、工作區、應用程式群組或應用程式的物件標識碼

某些 PowerShell Cmdlet 會要求您提供 Azure 虛擬桌面服務對象的物件識別碼。 範例如下：

• 若要擷取主機集區的物件標識碼，請執行下列命令：

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

• 若要擷取工作區的物件識別碼，請執行下列命令：

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

• 若要擷取應用程式群組的物件識別碼，請執行下列命令：

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

• 若要擷取傳統型應用程式的物件識別碼，請執行下列命令：

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

• 若要擷取應用程式群組中所有 RemoteApp 應用程式的物件識別碼，請執行下列命令：

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

後續步驟

現在您已瞭解如何搭配 Azure 虛擬桌面使用 Azure CLI 和 Azure PowerShell，以下是一些使用它們的文章：

• 使用 PowerShell 或 Azure CLI 建立 Azure 虛擬桌面主機集區
• 使用 PowerShell 或 Azure CLI 管理應用程式群組
• 如需完整的 PowerShell 參考檔，請參閱 Az.DesktopVirtualization。