Share via


Azure Virtual Desktop PowerShell

Importante

Este conteúdo aplica-se ao Ambiente de Trabalho Virtual do Azure com objetos do Ambiente de Trabalho Virtual do Azure Resource Manager. Se você estiver usando a Área de Trabalho Virtual do Azure (clássica) sem objetos do Azure Resource Manager, consulte 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 o PowerShell dos Serviços de Área de Trabalho Remota, consulte Azure Virtual Desktop PowerShell.

Enviar comentários

Visite a Comunidade Técnica de Ambiente de Trabalho Virtual do Azure para discutir o serviço de Ambiente de Trabalho Virtual do Azure com a equipa do produto e os 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 fornece maneiras de resolver problemas que podem ocorrer ao usá-los.

Erro: New-AzRoleAssignment: As informações fornecidas 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: Certifique-se das seguintes coisas.

  • O usuário deve ser sincronizado com o Microsoft Entra ID.
  • O usuário não deve estar vinculado ao comércio business-to-consumer (B2C) ou business-to-business (B2B).
  • O ambiente de Área de Trabalho Virtual do Azure deve estar vinculado à ID correta do Microsoft Entra.

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

Causa 1: A conta que está a ser utilizada não tem permissões de Proprietário na subscrição.

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 da ID do Microsoft Entra do ambiente ou não tem permissões para consultar a ID do Microsoft Entra onde o usuário está localizado.

Correção 2: Um usuário com permissões do Ative 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 dá suporte à seleção do local de pools de hosts, grupos de aplicativos e espaços de trabalho para armazenar metadados de serviço em determinados locais. Suas opções são restritas ao local onde 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 suportadas será publicada. Em vez disso, use uma das regiões suportadas.

Erro: New-AzWvdApplicationGroup deve estar no mesmo local do pool de hosts

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

Causa: há uma incompatibilidade de localização. Todos os pools de hosts, grupos de aplicativos e espaços de trabalho têm um local para armazenar metadados de serviço. Todos os objetos criados que estão associados uns aos outros devem estar no mesmo local. Por exemplo, se um pool de hosts estiver no , você também precisará criar os grupos de aplicativos no eastuseastus. Se você criar um espaço de trabalho para registrar esses grupos de aplicativos, esse espaço de trabalho também precisará estar dentro eastus .

Correção: recupere o local em que o pool de hosts foi criado e atribua o grupo de aplicativos que você está criando a esse mesmo local.

Próximos passos