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

Importante

Este conteúdo se aplica à Área de Trabalho Virtual do Azure (clássica), que não dá suporte a objetos do Azure Resource Manager na Área de Trabalho Virtual do Azure. Se você estiver tentando gerenciar objetos do Azure Resource Manager na Área de Trabalho Virtual do Azure, 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: Add-RdsAppGroupUser comando -- o UserPrincipalName especificado já está atribuído a um grupo de aplicativos RemoteApp no Pool de Host 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 área de trabalho remota e de aplicativos remotos do RemoteApp no mesmo pool de host de sessão.

Correção: Se o usuário precisar de um RemoteApp e um desktop, crie pools de host diferentes ou conceda acesso ao usuário ao desktop remoto, 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 no Microsoft Entra ID 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 2: 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 business to consumer (B2C) ou business-to-business (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 pode ser usada somente por administradores de implantação. Esses administradores são, geralmente, membros da equipe de Serviços da Á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á sendo usada não tem Serviços de Área de Trabalho Remota de Proprietário no locatário.

Correção 1: Um usuário com Serviços de Área de Trabalho Remota permissões de proprietário 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 do Microsoft Entra ID do locatário 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.

Observação

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

Erro: o 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 de folha do pool de host, ele não funcionará.

Correção: execute o comando a seguir 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 que ele tenha usuários atribuídos.

Próximas etapas

• Confira uma visão geral da solução de problemas da Área de Trabalho Virtual do Azure e das faixas de escalonamento em Visão geral da solução de problemas, comentários e suporte.
• Para solucionar problemas ao criar um pool de locatários e de hosts em um ambiente da Área de Trabalho Virtual do Azure, confira Criação de pool de locatários e de hosts.
• Confira como solucionar problemas durante a configuração de uma VM (máquina virtual), na Área de Trabalho Virtual do Azure, em Configuração da máquina virtual do host da sessão.
• Para solucionar problemas com conexões de cliente da Área de Trabalho Virtual do Azure, consulte Conexões do serviço da Área de Trabalho Virtual do Azure.
• Para solucionar problemas com clientes da Área de Trabalho Remota, confira Solucionar problemas do cliente da Área de Trabalho Remota
• Para saber mais sobre o serviço, consulte Ambiente da Área de Trabalho Virtual do Azure.
• Acompanhe um tutorial de solução de problemas em Tutorial: Solucionar problemas de implantações de modelos do Resource Manager.
• Para saber sobre as ações de auditoria, consulte Auditar operações com o Gerenciador de Recursos.
• Para saber sobre as ações para determinar os erros durante a implantação, consulte Exibir operações de implantação.