Azure 虚拟桌面 PowerShell

重要

本教程的内容适用于包含 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 'chinaeast' is not available for resource type 'Microsoft.DesktopVirtualization/hostpools'. List of available regions for the resource type is 'chinaeast2,chinanorth2'.

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

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

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

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

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

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

后续步骤