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

Azure 虚拟桌面 PowerShell

  • 项目

重要

本教程的内容适用于包含 Azure 资源管理器 Azure 虚拟桌面对象的 Azure 虚拟桌面。 如果你使用的是不包含 Azure 资源管理器对象的 Azure 虚拟桌面（经典），请参阅本文。

请参考本文来解决将 PowerShell 与 Azure 虚拟桌面配合使用时出现的错误和问题。 有关远程桌面服务 PowerShell 的详细信息，请参阅 Azure 虚拟桌面 PowerShell。

提供反馈

请访问 Azure 虚拟桌面技术社区，与产品团队和活跃的社区成员共同探讨 Azure 虚拟桌面服务。

在设置 Azure 虚拟桌面期间使用的 PowerShell 命令

本部分列出了在设置 Azure 虚拟桌面时通常使用的 PowerShell 命令，并提供使用这些命令时可能发生的问题的解决方法。

错误: New-AzRoleAssignment: 提供的信息未映射到 AD 对象 ID

New-AzRoleAssignment -SignInName "admins@contoso.com" -RoleDefinitionName "Desktop Virtualization User" -ResourceName "0301HP-DAG" -ResourceGroupName 0301RG -ResourceType 'Microsoft.DesktopVirtualization/applicationGroups'

原因：在绑定到 Azure 虚拟桌面环境的 Microsoft Entra 中找不到由 -SignInName 参数指定的用户。

解决方法：请确保符合以下要求。

  • 用户应同步到 Microsoft Entra ID。
  • 该用户不应绑定到企业到消费者 (B2C) 或企业到企业 (B2B) 商务应用。
  • Azure 虚拟桌面环境应已绑定到正确的 Microsoft Entra ID。

错误: New-AzRoleAssignment:“具有该对象 ID 的客户端未获授权，无法在该范围执行操作(代码: AuthorizationFailed)”

原因 1：所用的帐户在订阅中没有“所有者”权限。

解决方法 1：需要由拥有“所有者”权限的用户执行角色分配。 或者，需要将相应用户分配到“用户访问管理员”角色，以将某个用户分配到应用程序组。

原因 2：所用的帐户拥有“所有者”权限，但不是环境中 Microsoft Entra ID 的一部分，或者无权查询该用户所在的 Microsoft Entra ID。

解决方法 2：需要由拥有“Active Directory”权限的用户执行角色分配。

错误: New-AzWvdHostPool -- 该位置不可用于该资源类型

New-AzWvdHostPool_CreateExpanded: The provided location 'southeastasia' is not available for resource type 'Microsoft.DesktopVirtualization/hostpools'. List of available regions for the resource type is 'eastus,eastus2,westus,westus2,northcentralus,southcentralus,westcentralus,centralus'.

原因：Azure 虚拟桌面支持选择主机池、应用程序组和工作区的位置，以将服务元数据存储在特定的位置。 你的选项仅限于可使用此功能的位置。 此错误表示该功能在所选位置不可用。

解决方法：错误消息中会列出支持的区域。 请改用某个支持的区域。

错误: New-AzWvdApplicationGroup 必须与主机池位于同一位置

New-AzWvdApplicationGroup_CreateExpanded: ActivityId: e5fe6c1d-5f2c-4db9-817d-e423b8b7d168 Error: ApplicationGroup must be in same location as associated HostPool

原因：位置不匹配。 所有主机池、应用程序组和工作区都有一个用于存储服务元数据的位置。 所创建的相互关联的所有对象必须位于同一位置。 例如，如果主机池位于 eastus，则应用程序组也需要在 eastus 中创建。 如果创建一个工作区以将这些应用程序组注册到其中，则该工作区也需要位于 eastus。

解决方法：检索创建主机池的位置，然后将你要创建的应用程序组分配到该位置。

后续步骤