你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

将 Azure CLI 和 Azure PowerShell 与 Azure 虚拟桌面配合使用

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 门户本身自带 Azure Cloud Shell，其中提供 Azure CLI 和 Azure PowerShell（无需安装）；或者可以在 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 CLI 和 Azure PowerShell 与 Azure 虚拟桌面配合使用，下面是一些使用这些服务的文章：

• 使用 PowerShell 或 Azure CLI 创建 Azure 虚拟桌面主机池
• 使用 PowerShell 或 Azure CLI 管理应用程序组
• 有关完整的 PowerShell 参考文档，请参阅 Az.DesktopVirtualization。