PowerShell da Área de Trabalho Virtual do Azure

Importante

Este conteúdo se aplica à Área de Trabalho Virtual do Azure com objetos do Azure Resource Manager. Se você estiver usando a Área de Trabalho Virtual do Azure (clássica) sem objetos do Azure Resource Manager, confira este artigo.

Use este artigo para resolver erros e problemas ao usar o PowerShell com a Área de Trabalho Virtual do Azure. Para obter mais informações sobre PowerShell dos Serviços de Área de Trabalho Remota, confira PowerShell da Área de Trabalho Virtual do Azure.

Fornecer comentários

Visite a Comunidade Tecnológica da Área de Trabalho Virtual do Azure para comentar sobre o serviço da Área de Trabalho Virtual do Azure com a equipe do produto e membros ativos da comunidade.

Comandos do PowerShell usados durante a instalação da Área de Trabalho Virtual do Azure

Esta seção lista os comandos do PowerShell que normalmente são usados durante a configuração da Área de Trabalho Virtual do Azure e apresenta maneiras de resolver problemas que podem ocorrer ao usá-los.

Erro: New-AzRoleAssignment: as informações apresentadas não são mapeadas para um ID de objeto do AD

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

Causa: O usuário especificado pelo parâmetro -SignInName não pode ser encontrado no Microsoft Entra vinculado ao ambiente de Área de Trabalho Virtual do Azure.

Correção: leve o seguinte em consideração.

  • O usuário deve ser sincronizado com o Microsoft Entra ID.
  • O usuário não deve estar vinculado ao comércio entre empresa e consumidor (B2C) nem entre empresas (B2B).
  • O ambiente de Área de Trabalho Virtual do Azure deve estar vinculado ao Microsoft Entra ID correto.

Erro: New-AzRoleAssignment: “O cliente com o ID de objeto não tem autorização para executar a ação sobre o escopo (código: AuthorizationFailed)”

Causa 1: a conta usada não tem permissões de proprietário na assinatura.

Correção 1: um usuário com permissões de proprietário precisa executar a atribuição de função. Como alternativa, o usuário precisa ser atribuído à função de administrador de acesso de usuário para atribuir um usuário a um grupo de aplicativos.

Causa 2: a conta que está sendo usada tem permissões de proprietário, mas não faz parte do Microsoft Entra ID do ambiente ou não tem permissões para consultar o Microsoft Entra ID onde o usuário está localizado.

Correção 2: um usuário com permissões do Active Directory precisa executar a atribuição de função.

Erro: New-AzWvdHostPool – o local não está disponível para o tipo de recurso

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'.

Causa: a Área de Trabalho Virtual do Azure permite selecionar o local de pools de host, grupos de aplicativos e workspaces para armazenar metadados de serviço em determinados locais. Suas opções estão restritas ao local em que esse recurso está disponível. Esse erro significa que o recurso não está disponível no local escolhido.

Correção: na mensagem de erro, uma lista de regiões com suporte será publicada. Use uma das regiões com suporte.

Erro: New-AzWvdApplicationGroup precisa estar no mesmo local que o pool de host

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

Causa: há uma incompatibilidade de local. Todos os pools de host, grupos de aplicativos e workspaces têm um local para armazenar metadados de serviço. Todos os objetos que você criar que estão associados entre si devem estar no mesmo local. Por exemplo, se um pool de host estiver em eastus, você também precisará criar os grupos de aplicativos em eastus. Se você criar um workspace para registrar esses grupos de aplicativos, ele também precisará estar em eastus.

Correção: recupere o local em que o pool de host foi criado e, em seguida, atribua o grupo de aplicativos que você está criando para o mesmo local.

Próximas etapas