Renomeou o UPN/e‑mail de um usuário (por exemplo, de testaccount para ta) e o Microsoft Teams continua mostrando o endereço antigo nos cartões de contato? Este guia prático explica por que isso acontece e traz um passo a passo seguro para limpar caches, revisar aliases e sincronizar.
Visão geral do problema
Em ambientes Microsoft 365, alterar o UPN (User Principal Name) e o endereço SMTP principal normalmente resolve a maioria dos cenários de renomeação de conta. Ainda assim, o Microsoft Teams pode exibir dados obsoletos — como o e‑mail antigo de testaccount@… — nos cartões de contato (botões de e‑mail e chat), mesmo quando o Active Directory local e o Centro de Administração do Microsoft 365 já refletem o novo valor (ta@…). A causa costumeira é uma combinação de:
- Aliases SMTP persistentes em Exchange Online (o alias antigo ainda existe e, portanto, aparece em superfícies de contato).
- Propagação entre serviços (Microsoft Entra ID — antigo Azure AD, Exchange Online, Perfil do M365 e Teams).
- Cache do cliente (Teams no desktop e apps móveis mantêm dados por algum tempo).
Como o Teams agrega dados
O Teams consolida informações de perfil provenientes de múltiplas origens. Entender essa “fonte da verdade” ajuda a decidir onde agir.
| Origem | O que é sincronizado | Observação prática |
|---|---|---|
| Azure AD / Microsoft Entra ID (AAD) | Nome, UPN, e‑mail principal, aliases | Alterações podem levar horas para propagar entre serviços. |
| Exchange Online / Outlook | Endereços SMTP (primário e secundários), aliases, foto | Se um alias antigo permanecer, ele pode continuar visível em cartões de contato. |
| Cache local do Teams | Dados exibidos no cliente (cartões, busca, presença) | Persistem após mudanças no diretório; limpar cache força atualização. |
Diagnóstico rápido
Antes de sair removendo itens, valide de onde o dado antigo está vindo. Use a tabela abaixo como checklist.
| Sinal | Onde aparece | Provável origem | Ação imediata |
|---|---|---|---|
| E‑mail antigo visível no cartão de contato do Teams | Teams (desktop e web) | Alias SMTP ainda presente ou cache do cliente | Remover alias no Exchange Online e limpar cache do Teams |
| Usuário recebe mensagens enviadas ao endereço antigo | Outlook/Exchange | Alias SMTP secundário mantido | Decidir: manter por compatibilidade ou mover alias para caixa compartilhada |
| Somente uma máquina específica mostra o dado antigo | Um dispositivo do usuário | Cache local do app | Limpar cache; sair/entrar novamente no Teams |
| No Outlook, autocompletar sugere o e‑mail antigo | Outlook (Desktop/Mobile) | AutoComplete local/contatos sugeridos | Excluir sugestão/contato local; não é problema de diretório |
Passo a passo para remover dados desatualizados
Limpar o cache do cliente Teams
Teams clássico (aplicativo legado):
- Sair do Teams.
- Fechar o app (verifique o ícone na bandeja do sistema e encerre).
- Excluir todo o conteúdo da pasta
%appdata%\Microsoft\Teams\Cache. - Iniciar o Teams e entrar novamente.
Novo Teams: acesse ⚙ Configurações > App > Redefinir para limpar dados do aplicativo. Em casos teimosos, saia do app, feche-o completamente e reinicie o computador.
| Plataforma | Pastas úteis para limpeza adicional (se necessário) | Observações |
|---|---|---|
| Windows (clássico) | %appdata%\Microsoft\Teams\ → Cache, tmp, GPUCache, IndexedDB, Local Storage, databases | Exclua o conteúdo dessas subpastas com o Teams fechado. |
| macOS (clássico) | ~/Library/Application Support/Microsoft/Teams/ | Feche o Teams e apague conteúdo de Cache e correlatos. |
| Android | Ajustes > Apps > Teams > Armazenamento > Limpar cache | Se persistir, Forçar parada e abrir novamente. |
| iOS/iPadOS | Sair do app > feche-o do alternador > se necessário, reinstalar | O iOS não expõe “Limpar cache”. Reinstalar renova dados locais. |
Confirmar que o endereço antigo não está mais no diretório (AAD/Entra ID)
No Microsoft Entra ID (antigo Azure AD):
- Abrir o portal → Users → usuário em questão → Emails.
- Remover aliases obsoletos (qualquer ocorrência de
testaccount@). - Aguardar a replicação entre serviços. Em ambientes híbridos, isso pode levar até 24 horas.
Verificar e limpar aliases em Exchange Online
No Exchange Admin Center:
- Abrir o usuário → Mail → Aliases.
- Excluir o alias antigo
testaccount@contoso.com.
Dica: endereços X500: servem para compatibilidade e não são exibidos em cartões; normalmente mantenha-os. O que aparece é o SMTP primário (SMTP:) e os secundários (smtp:).
Forçar sincronização em ambiente híbrido
Se você utiliza AD Connect, rode um ciclo delta para acelerar a convergência:
Start-ADSyncSyncCycle -PolicyType Delta
Atualizar manualmente o cartão de contato (opcional)
No Teams, clique no avatar do usuário → Perfil → ✎ Editar (quando permitido pela política). Em geral, o e‑mail exibido é puxado do diretório/Exchange; editar aqui tem efeito limitado e temporário.
Último recurso: recriar o usuário
Se a identidade ficou inconsistente (UPN, objeto duplicado ou histórico de migrações), excluir e recriar pode resolver — mas é a opção mais disruptiva. Riscos: novo ObjectId, impacto em OneDrive/SharePoint/Teams, permissões e histórico. Só faça após backup, janela de manutenção e plano de comunicação. Em muitos casos, corrigir alias/UPN e limpar cache é suficiente.
Dicas complementares e boas práticas
- Tempo de propagação: mudanças em Entra ID/Exchange podem levar de minutos a algumas horas para refletir no Teams. Planeje renomeações fora do horário de pico.
- Clientes móveis: depois de consertar no desktop, solicite ao usuário encerrar e reabrir o app no iOS/Android para invalidar o cache local.
- Separar compatibilidade de visibilidade: se precisar manter o recebimento no endereço antigo, mova o alias para uma caixa de correio compartilhada ou grupo em vez de deixá-lo no usuário. Assim, não aparece no cartão pessoal.
- Evite múltiplas fontes conflitantes: perfis salvos no Outlook (contatos locais) e cache de autocompletar podem confundir os usuários. Limpe-os ao final.
- Documente a mudança: registre o UPN antigo e o novo, aliases removidos e carimbos de tempo de sincronização. Ajuda na auditoria e em chamados futuros.
Comandos PowerShell úteis
Remover um alias específico em Exchange Online:
Set-Mailbox ta -EmailAddresses @{remove="testaccount@contoso.com"}
Listar endereços SMTP de uma caixa:
Get-Mailbox ta | Select-Object PrimarySmtpAddress, EmailAddresses
Conferir o que o Teams “vê” para o usuário (PowerShell do Teams):
# Requer módulo MicrosoftTeams
Get-CsOnlineUser -Identity ta@contoso.com | Select-Object DisplayName, UserPrincipalName, SipAddress
Verificar atributos de diretório (Graph/Entra ID):
# Exemplo com MS Graph PowerShell
Get-MgUser -UserId ta@contoso.com -Property proxyAddresses, otherMails | `
Select-Object Id, UserPrincipalName, @{n="Proxy";e={$_.proxyAddresses}}
Forçar sincronização (AD Connect):
Start-ADSyncSyncCycle -PolicyType Delta
Cenários híbridos e tempos de propagação
Em ambientes com Active Directory local e Exchange Online, a cadeia de sincronização é:
- AD local (alteração de UPN/atributos) →
- AD Connect (ciclo Delta ou Initial) →
- Microsoft Entra ID (objeto sincronizado) →
- Serviços M365 (Exchange Online, SharePoint, Teams) →
- Clientes (Outlook, Teams, mobile) com seus caches.
Qualquer atraso intermediário mantém o dado antigo visível. Por isso, alinhe horários de mudança, rode um Start-ADSyncSyncCycle, monitore no Entra ID e no Exchange, e só então peça a limpeza de cache nos endpoints.
Soluções quando é preciso manter o alias antigo
Algumas equipes mantêm o e‑mail antigo por um período de transição. Se isso for necessário, mas você não deseja que o alias apareça no cartão do usuário:
- Caixa compartilhada “legado”: crie uma mailbox compartilhada com o endereço antigo e configure forward para o novo endereço. Assim, o usuário não carrega o alias visualmente.
- Grupo de distribuição: atribua o endereço antigo a um grupo de distribuição com o usuário como membro. Preserva a entrega sem expor no cartão pessoal.
- Regra de transporte: quando aplicável, redirecione mensagens destinadas ao endereço antigo para o novo.
Nota: evite manter o alias antigo diretamente no usuário se a visibilidade pública for um problema — o cartão de contato tende a exibir esses endereços.
Erros comuns e como evitá-los
- Remover X500 sem avaliar impacto: esses endereços evitam erros de roteamento de calendários/convites antigos. Na dúvida, mantenha.
- Confiar apenas no UPN: mudar o UPN não altera automaticamente o SMTP primário em todos os cenários. Verifique o PrimarySmtpAddress e os aliases.
- Ignorar o Outlook do usuário: contatos pessoais e autocompletar podem continuar sugerindo o endereço antigo. Oriente a limpeza local.
- Esquecer dos apps móveis: mesmo após corrigir no desktop, o celular pode manter uma cópia em cache.
- Recriar usuário sem plano: pode quebrar permissões e históricos. Use como último recurso.
Checklist de validação
- Diretório: UPN e otherMails/proxyAddresses sem
testaccount@. - Exchange: PrimarySmtpAddress atualizado; alias antigo removido (ou movido para outra entidade).
- Teams: cartão de contato e busca mostram apenas o endereço novo.
- Outlook: autocompletar limpo; sem contatos locais com endereço antigo.
- Dispositivos: cache limpo no desktop e no mobile.
- Híbrido: ciclo
Deltaexecutado e concluído no AD Connect.
Perguntas frequentes
Quanto tempo até o Teams refletir a mudança?
De alguns minutos a algumas horas, dependendo de sincronização e caches. Se for híbrido, considere até 24h.
Mudei o UPN, mas o e‑mail principal não mudou. É normal?
Sim, são atributos distintos. Ajuste também o PrimarySmtpAddress em Exchange Online.
Posso esconder um alias do cartão sem removê-lo?
Não de forma confiável. Para compatibilidade sem visibilidade, mova o alias para uma caixa compartilhada ou grupo.
O Teams web e o desktop mostram dados diferentes. Por quê?
O desktop faz cache local mais agressivo. Limpar o cache do app costumava equalizar com o web.
Resumo
Quando o Teams insiste em mostrar um e‑mail antigo, as ações mais eficazes são: limpar o cache do cliente, remover aliases SMTP obsoletos no Exchange Online e, em ambientes híbridos, forçar um ciclo de sincronização no AD Connect. Na grande maioria dos casos, isso elimina o endereço antigo dos cartões de contato. Caso precise manter a entrega no endereço legado, opte por realocar o alias para uma caixa compartilhada ou grupo, preservando compatibilidade sem poluir o perfil do usuário.
Passo a passo essencial (resumo operacional)
- Limpar o cache do Teams
Clássico: sair → fechar → apagar%appdata%\Microsoft\Teams\Cache→ abrir.
Novo Teams: ⚙ Configurações → App → Redefinir. - Checar Entra ID (AAD) para garantir que
testaccount@não aparece em Emails/aliases. - Checar Exchange Online e remover o alias antigo do usuário (Mail > Aliases).
- Híbrido: executar
Start-ADSyncSyncCycle -PolicyType Delta. - Opcional: atualizar manualmente o cartão, se permitido.
- Último recurso: considerar recriar o usuário com planejamento e mitigação de impactos.
Exemplos práticos de comandos
Exchange Online – remover alias e revisar endereços
# Remover alias antigo do usuário
Set-Mailbox ta -EmailAddresses @{remove="testaccount@contoso.com"}
Conferir e-mails atuais
Get-Mailbox ta | Select-Object PrimarySmtpAddress, EmailAddresses
Conferir o recipient resolvido (útil se houver regras de transporte ou políticas)
Get-EXORecipient -Identity ta | Format-List PrimarySmtpAddress,EmailAddresses,RecipientTypeDetails Teams PowerShell – conferir o que o serviço conhece
Connect-MicrosoftTeams
Get-CsOnlineUser -Identity ta@contoso.com | `
Select-Object DisplayName, UserPrincipalName, SipAddress, TenantId
AD Connect – sincronização forçada
# Executar no servidor do AD Connect
Start-ADSyncSyncCycle -PolicyType Delta
Seguindo este roteiro, você alinha diretório, Exchange e cliente — e o Teams para de exibir o endereço antigo.