Compartilhar via

PowerShell (clássico) da Área de Trabalho Virtual do Azure

  • Artigo

Importante

Esse conteúdo se aplica à Área de Trabalho Virtual do Azure (clássica), que não dá suporte a objetos da Área de Trabalho Virtual do Azure Resource Manager. Se você estiver tentando gerenciar objetos do Azure Resource Manager Área de Trabalho Virtual do Azure, 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 do PowerShell da Área de Trabalho Virtual do Azure.

Fornecer comentários

Visite a Comunidade Técnica de Azure Virtual Desktop para discutir o serviço Azure Virtual Desktop com a equipe de desenvolvimento de produtos 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 fornece maneiras de resolver problemas que podem ocorrer ao usá-los.

Erro: comando Add-RdsAppGroupUser -- o UserPrincipalName especificado já está atribuído a um grupo de aplicativos do RemoteApp no Grupo de Hosts especificado

Add-RdsAppGroupUser -TenantName <TenantName> -HostPoolName <HostPoolName> -AppGroupName 'Desktop Application Group' -UserPrincipalName <UserName>

Causa: O nome de usuário usado já foi atribuído a um grupo de aplicativos de um tipo diferente. Os usuários não podem ser atribuídos a um grupo de aplicativos remote desktop e RemoteApp no mesmo pool de hosts de sessão.

Correção: Se o usuário precisar de um aplicativo remoto e do desktop remoto, crie pools de host diferentes ou conceda apenas ao usuário acesso ao desktop remoto, permitindo o uso de qualquer aplicativo na VM do host de sessão.

Erro: comando Add-RdsAppGroupUser – O UserPrincipalName especificado não existe na ID do Microsoft Entra associada ao tenant da Área de Trabalho Remota

Add-RdsAppGroupUser -TenantName <TenantName> -HostPoolName <HostPoolName> -AppGroupName "Desktop Application Group" -UserPrincipalName <UserPrincipalName>

Causa: O usuário especificado pelo -UserPrincipalName não pode ser encontrado no Microsoft Entra vinculado ao locatário do Azure Virtual Desktop.

Correção: Confirmar os itens na lista a seguir.

  • O usuário é sincronizado com a ID do Microsoft Entra.
  • O usuário não está vinculado ao negócio ao consumidor (B2C) ou ao comércio B2B (entre empresas).
  • O locatário da Área de Trabalho Virtual do Azure está vinculado à ID correta do Microsoft Entra.

Erro: Get-RdsDiagnosticActivities -- O usuário não está autorizado a consultar o serviço de gerenciamento

Get-RdsDiagnosticActivities -ActivityId <ActivityId>

Causa: parâmetro -TenantName

Correção: problema Get-RdsDiagnosticActivities com -TenantName <TenantName>.

Erro: Get-RdsDiagnosticActivities -- o usuário não está autorizado a consultar o serviço de gerenciamento

Get-RdsDiagnosticActivities -Deployment -username <username>

Causa: Usando -Deployment opção.

Correção: -Deployment opção só pode ser usada pelos administradores de implantação. Esses administradores geralmente são membros da equipe de Serviços de Área de Trabalho Remota/Área de Trabalho Virtual do Azure. Substitua o interruptor -Deployment pelo -TenantName <TenantName>.

Erro: New-RdsRoleAssignment -- o usuário não está autorizado a consultar o serviço de gerenciamento

Causa 1: A conta que está sendo usada não tem permissões de Proprietário dos Serviços de Área de Trabalho Remota no locatário.

Correção 1: Um usuário com permissões de proprietário dos Serviços de Área de Trabalho Remota precisa executar a atribuição de função.

Causa 2: A conta que está sendo usada tem permissões de proprietário dos Serviços de Área de Trabalho Remota, mas não faz parte da ID do Microsoft Entra do locatário 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 Active Directory precisa executar a atribuição de função.

Nota

New-RdsRoleAssignment não pode conceder permissões a um usuário que não existe na ID do Microsoft Entra.

Erro: SessionHostPool não pôde ser excluído

Esse erro geralmente ocorre quando você executa o comando a seguir para tentar remover um host de sessão.

Remove-RdsHostPool -TenantName <TenantName> -Name <HostPoolName>

Causa: Se você executar o comando antes de excluir os objetos folha do pool de host, ele não funcionará.

Correção: Execute o seguinte comando para excluir o host da sessão.

Get-RdsSessionHost-TenantName <TenantName> -Hostpook <HostPoolName> | Remove-RdsSessionHost -Force

O uso do comando force permitirá que você exclua o host da sessão mesmo se ele tiver atribuído usuários.

Próximas etapas