Azure Virtual Desktop (clássico) PowerShell

  • Artigo

Importante

Este conteúdo aplica-se ao Ambiente de Trabalho Virtual do Azure (clássico), que não suporta objetos do Azure Resource Manager do Ambiente de Trabalho Virtual do Azure. Se você estiver tentando gerenciar objetos da Área de Trabalho Virtual 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: comando Add-RdsAppGroupUser -- O UserPrincipalName especificado já está atribuído a um grupo de aplicativos RemoteApp no Pool 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 uma área de trabalho remota e a um grupo de aplicativos RemoteApp no mesmo pool de hosts de sessão.

Correção: Se o usuário precisar de um RemoteApp e da área de trabalho, crie pools de hosts diferentes ou conceda apenas ao usuário acesso à área de trabalho remota, o que permitirá o uso de qualquer aplicativo na VM do host da sessão.

Erro: Comando Add-RdsAppGroupUser -- O UserPrincipalName especificado não existe na ID do Microsoft Entra associada ao locatário 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 da Área de Trabalho Virtual do Azure.

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

  • O usuário é sincronizado com o Microsoft Entra ID.
  • O usuário não está vinculado ao comércio entre empresas e consumidores (B2C) ou entre empresas (B2B).
  • 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 a opção -Deployment.

Correção: -A opção de implantação só pode ser usada por administradores de implantação. Esses administradores geralmente são membros da equipe dos Serviços de Área de Trabalho Remota/Área de Trabalho Virtual do Azure. Substitua a opção -Deployment por -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á a ser utilizada não tem permissões de Proprietário dos Serviços de Ambiente de Trabalho Remoto no inquilino.

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á a ser utilizada tem permissões de proprietário dos Serviços de Ambiente de Trabalho Remoto, mas não faz parte do ID do Microsoft Entra do inquilino ou não tem permissões para consultar o ID do Microsoft Entra onde o utilizador está localizado.

Correção 2: Um usuário com permissões do Ative 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

Este erro geralmente acontece quando você executa o seguinte comando 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 hosts, 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

Usar o comando force permitirá que você exclua o host da sessão, mesmo que ele tenha atribuído usuários.

Próximos passos