以 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 入口網站原生的 Azure Cloud Shell 中使用，或者您可以在 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

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

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

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

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

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

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

  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 cmdlets 建立 Azure 虛擬桌面服務物件時，您需要指定您欲建立它們的 Azure 區域。 若要尋找要搭配 -Location 參數使用的 Azure 區功能變數名稱，請執行下列命令，並使用資料行中的 Location 值：

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

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

部分 PowerShell Cmdlet 需要您提供 Azure 虛擬桌面服務物件的物件 ID。 以下列出一些範例：

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

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

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

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

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

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

• 若要擷取桌面應用程式的物件 ID，請執行下列命令：

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

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

  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。