Se o banner do Teams insiste em avisar que o Classic será descontinuado, mesmo com Windows 10/11 compatível e o dispositivo ingressado no AAD, este guia mostra como identificar o pré‑requisito exato que falhou, corrigir políticas que bloqueiam MSIX e concluir a migração com segurança.
Visão geral — por que o novo Microsoft Teams não instala ou não migra
O novo Microsoft Teams (work or school) é distribuído como um aplicativo MSIX e depende de componentes do Windows — principalmente o Microsoft Edge WebView2 Runtime e o Windows App Installer. Em ambientes corporativos, políticas do Intune/GPO ou controles de rede podem impedir a implantação silenciosa mesmo quando o sistema operacional cumpre os requisitos. O resultado típico é:
- Banner “Classic Teams will soon be unavailable… update your OS to meet requirements or contact your IT admin”.
- Ou a mensagem “Your org is installing the new version of Teams. We’ll let you know when it’s ready.” que nunca sai do lugar.
Na prática, quando o Windows já está suportado, os bloqueios restantes quase sempre se resumem a dois eixos: política de atualização do Teams (o serviço não entrega o novo cliente) e capacidade do Windows de instalar MSIX por usuário (o dispositivo bloqueia a instalação). O caminho mais curto até a causa é ler os logs do AppxDeployment durante a tentativa e, em paralelo, verificar as políticas ativas para o usuário/dispositivo.
Sintomas típicos e o que significam
| Sintoma | Provável causa | Como confirmar |
|---|---|---|
| Banner do Classic pede atualização de SO mesmo estando no Windows 10/11 suportado | Dependência ausente (WebView2/App Installer) ou falha de implantação MSIX | Event Viewer em AppxDeployment‑Server/Operational; erros 0x80073… |
| Texto “Your org is installing…” persiste por dias | Política do Teams em Classic only ou bloqueio de MSIX no dispositivo | Teams admin center (política) e AppxDeployment durante a alternância |
| Toggle do novo Teams aparece, mas nada instala | Store desativada, AllowAllTrustedApps desabilitado, App Installer desatualizado | GPO/Intune e “Aplicativos instalados” do Windows |
| Instala, mas volta ao Classic após reiniciar | Política de atualização conflitante ou limpeza de perfil | Conferir atribuições por grupo e scripts de limpeza |
Checklist rápido para resolver
- Atualizar totalmente o Windows 10/11 e reiniciar.
- Garantir que WebView2 Runtime e App Installer estão instalados/atuais.
- Validar a Teams Update Policy do usuário (permitir novo cliente).
- Remover bloqueios a MSIX/Store em GPO/Intune.
- Limpar o cache do Teams e tentar novamente.
- Recolher logs do AppxDeployment e do cliente Teams.
- Se necessário, instalar o novo Teams manualmente (Store/Intune/winget).
- Persistindo, abrir chamado pelo Admin Center anexando os logs.
Verificações rápidas que resolvem boa parte dos casos
Windows atualizado
- Instale todas as atualizações pendentes em Configurações > Windows Update e reinicie.
- Evite “metered connection” ou adiamentos que posterguem o Desktop App Installer.
Teams atualizado
- No cliente Classic, acesse Perfil (avatar) → Check for updates e aguarde a sincronização.
- Se a conta usar política Microsoft controlled, a migração pode ser faseada; ainda assim, o dispositivo não deve barrar o MSIX.
WebView2 Runtime e App Installer presentes
O novo Teams depende dos componentes:
- Microsoft Edge WebView2 Runtime — listado como “Microsoft Edge WebView2 Runtime” em “Aplicativos instalados”.
- App Installer (também aparece como “Desktop App Installer”).
Comandos úteis em PowerShell para inspecionar:
# Verificar presença do novo Teams (MSIX)
Get-AppxPackage -Name MSTeams -AllUsers
Verificar o WebView2 Runtime
Get-AppxPackage -Name WebView2 -AllUsers
Verificar o App Installer
Get-AppxPackage -Name Microsoft.DesktopAppInstaller -AllUsers
Versão do Winget (usa o App Installer)
winget --info Conectividade de rede e antivírus
Confirme que firewall/antivírus/SSL inspection não bloqueiam os CDNs e serviços Microsoft usados pelo Teams, como .teams.microsoft.com, .skype.com, .microsoftonline.com, officecdn.microsoft.com, .azureedge.net e domínios de distribuição do Edge/Store. Para testar rapidamente:
# Testes de porta 443 para CDNs relevantes
Test-NetConnection officecdn.microsoft.com -Port 443
Test-NetConnection teams.microsoft.com -Port 443
Se necessário, desabilite temporariamente o antivírus para descartar interferência (reabilite após o teste).
Licença e serviço
No Microsoft 365 Admin Center, verifique se a licença do usuário inclui Teams e se o serviço não está desabilitado no nível do usuário ou via política.
Limpeza de cache do Teams
Limpar o cache resolve estados incoerentes entre o cliente Classic e o novo MSIX.
- Pelo cliente: Configurações → Geral/Privacidade → Clear cache, feche completamente e reabra o Teams.
- Manual (quando a opção não existir): feche o Teams (incluindo o ícone da bandeja) e apague as pastas de cache.
Pastas mais comuns (variando por build):
# Teams Classic (por perfil de usuário)
%AppData%\Microsoft\Teams
%LocalAppData%\Microsoft\Teams
Novo Teams (MSIX)
%LocalAppData%\Packages\MSTeams\_8wekyb3d8bbwe\LocalCache
%LocalAppData%\Packages\MSTeams\_8wekyb3d8bbwe\LocalState Dica: scripts de limpeza devem preservar credenciais/SSO; remova apenas cache, GPUCache, CacheStorage e bancos locais, não as pastas de identidade.
Políticas que bloqueiam a instalação do novo Teams
Política de atualização do Teams
No Teams admin center, a política Teams update policy define a experiência do usuário:
- Classic only: impede a migração. O botão/toggle pode aparecer, mas a instalação não ocorre.
- Microsoft controlled: a Microsoft gerencia o ritmo, habilitando progressivamente.
- New Teams: força o novo cliente para os usuários alvo.
Coloque os usuários afetados em uma política que permita o novo cliente (idealmente por grupos) e aguarde a propagação.
GPO/Intune que restringem MSIX e a Microsoft Store
Como o novo Teams é um MSIX por usuário, certas políticas impedem a instalação silenciosa. Revise especialmente:
| Componente/Política | Onde fica | O que verificar |
|---|---|---|
| Turn off the Store application | GPO: Windows Components > Store | Se Enabled, a Store e dependências podem ser bloqueadas. Preferir Not configured ou permitir via Intune. |
| Allow all trusted apps to install (AllowAllTrustedApps) | GPO: Windows Components > App Package Deployment Registro: HKLM\SOFTWARE\Policies\Microsoft\Windows\Appx | Deve estar Enabled para permitir MSIX confiáveis assinados. |
| Bloqueio de instalação por usuário | GPO/Intune: restrições de aplicativos | Evite políticas que exijam apenas instalação por máquina para todos os apps. |
| App Installer desatualizado | Aplicativos instalados | Atualize o “Desktop App Installer” via Windows Update/Store. |
Consultas rápidas em PowerShell:
# Ler AllowAllTrustedApps
Get-ItemProperty -Path "HKLM:\SOFTWARE\Policies\Microsoft\Windows\Appx" |
Select-Object AllowAllTrustedApps
GPO da Store (RemoveWindowsStore: 1 = desativar Store)
Get-ItemProperty -Path "HKLM:\SOFTWARE\Policies\Microsoft\WindowsStore" |
Select-Object RemoveWindowsStore No Intune, prefira o tipo de app Microsoft Store app (new) e pesquise “Microsoft Teams (work or school)”. Atribua como Required aos grupos corretos. Evite empacotamentos próprios quando possível; o fluxo da Store cuida de arquiteturas (x64/x86/ARM64) e atualizações.
Diagnóstico com logs — encontre a causa em minutos
Logs de instalação MSIX no Windows
Navegue até Event Viewer → Applications and Services Logs → Microsoft‑Windows‑AppxDeployment‑Server/Operational e AppxPackaging/OM. Tente alternar para o novo Teams e observe eventos com “MSTeams”.
Comando para filtrar:
Get-WinEvent -LogName "Microsoft-Windows-AppxDeployment-Server/Operational" `
| Where-Object { $_.Message -match "MSTeams" } `
| Select-Object TimeCreated, Id, LevelDisplayName, Message -First 30
Erros 0x80073… mais frequentes e como agir
| Código | Significado provável | Ação recomendada |
|---|---|---|
| 0x80073CF3 | Dependência ausente/versão incompatível | Atualizar WebView2 e App Installer; aplicar Windows Update. |
| 0x80073D02 | Arquivo em uso | Fechar totalmente o Teams/Edge; reiniciar e tentar novamente. |
| 0x80073CFB | Conflito de pacote | Remover versão antiga/corrompida do MSTeams e reinstalar. |
| 0x80073CFC | Pacote já existe | Forçar reinstall/repair pelo Intune/Store; limpar cache. |
| 0x800B0109 | Cadeia de certificado | Política de confiança alterada; rever inspeção SSL e raiz corporativa. |
Logs do cliente Teams
No cliente, pressione Ctrl + Alt + Shift + 1 para exportar um ZIP de logs. Procure por mensagens contendo bootstrapper, msix, install new teams ou falhas de policy. Guarde este ZIP para eventual suporte.
Quando aparece “Your org is installing the new version of Teams…” e nada acontece
Esse texto indica que o serviço sinalizou a migração, mas a instalação local não avançou por uma destas razões:
- Política do Teams bloqueando: se o usuário estiver em Classic only, o toggle mostra a mensagem mas a instalação não será disparada.
- Dispositivo bloqueando MSIX: Store desativada, AllowAllTrustedApps desabilitado, App Installer desatualizado ou bloqueado pelo antivírus.
- Cache inconsistente: o cliente acredita que está aguardando o serviço, mas a tentativa falha localmente.
Como resolver de forma objetiva:
- Confirme a política do usuário (coloque em Microsoft controlled ou New Teams).
- Revise e ajuste GPO/Intune para permitir MSIX por usuário.
- Limpe o cache do Teams e tente novamente.
- Se o bloqueio persistir, implante diretamente o “Microsoft Teams (work or school)” pelo Intune/Store para os PCs afetados.
- Recolha os eventos do AppxDeployment durante a tentativa para comprovar a causa.
Instalação manual e alternativas de contingência
- Teams Web: use em um navegador suportado enquanto corrige o endpoint.
- Instalação pela Microsoft Store: abra a Store, pesquise “Microsoft Teams (work or school)” e instale autenticado com a conta corporativa.
- Intune: adicione “Microsoft Teams (work or school)” como Microsoft Store app (new) e atribua a grupos Required.
- Winget (quando permitido):
winget install --id Microsoft.Teams --source msstore(ajuste conforme o catálogo disponível no seu ambiente).
Fluxo de decisão rápido para a mesa de service desk
- Outro usuário no mesmo PC consegue migrar? Se não, foco no dispositivo (política/antivírus/rede). Se sim, foco na política do usuário.
- Execute o teste de WebView2 + App Installer. Se faltando, corrija e repita.
- Revise Teams Update Policy. Evite Classic only.
- Checar AllowAllTrustedApps e a Store. Ajuste para permitir MSIX confiáveis.
- Reproduza o problema e colete AppxDeployment‑Server/Operational. Use o código 0x80073… para direcionar a ação.
- Sem evolução, force a instalação via Store/Intune e anexe logs ao chamado.
Scripts e comandos úteis para acelerar o diagnóstico
# 1) Estado do pacote do novo Teams
Get-AppxPackage -Name MSTeams -AllUsers | Format-List Name, PackageFullName, Status
2) Versões dos componentes de dependência
Get-AppxPackage -Name WebView2 -AllUsers | Select Name, Version
Get-AppxPackage -Name Microsoft.DesktopAppInstaller -AllUsers | Select Name, Version
3) Políticas de Appx e Store
"Appx policies:", (Get-ItemProperty "HKLM:\SOFTWARE\Policies\Microsoft\Windows\Appx") |
Format-List \*
"Store policies:", (Get-ItemProperty "HKLM:\SOFTWARE\Policies\Microsoft\WindowsStore") |
Format-List \*
4) Eventos do AppxDeployment relacionados ao MSTeams (últimas 2h)
\$since = (Get-Date).AddHours(-2)
Get-WinEvent -LogName "Microsoft-Windows-AppxDeployment-Server/Operational" |
Where-Object { \$.TimeCreated -ge \$since -and \$.Message -match "MSTeams" } |
Select TimeCreated, Id, LevelDisplayName, Message
5) Testes de conectividade para CDNs críticos
\$hosts = "officecdn.microsoft.com","teams.microsoft.com","login.microsoftonline.com"
\$hosts | ForEach-Object { Test-NetConnection $\_ -Port 443 } Tabela de causa → confirmação → correção
| Causa | Como confirmar | Como corrigir |
|---|---|---|
| Política do Teams em Classic only | Teams admin center > Update policies | Mudar para Microsoft controlled ou New Teams e aguardar a propagação. |
| WebView2 ausente | “Aplicativos instalados” ou Get-AppxPackage WebView2 | Instalar/atualizar o runtime do WebView2. |
| App Installer desatualizado | Get-AppxPackage Microsoft.DesktopAppInstaller | Atualizar via Windows Update/Store; permitir Desktop App Installer no ambiente. |
| Store desativada por GPO | RemoveWindowsStore = 1 no Registro | Definir como Not configured ou liberar via Intune para o grupo alvo. |
| AllowAllTrustedApps desabilitado | AllowAllTrustedApps = 0 | Habilitar para permitir MSIX assinados. |
| Antivírus bloqueando conteúdo da Store/CDN | Testes Test-NetConnection; logs do AV | Criar exceções para domínios Microsoft; testar sem o AV para validar hipótese. |
| Conflito de pacote do MSTeams | Erro 0x80073CFB/0x80073CFC nos logs | Remover pacote corrompido e reinstalar pela Store/Intune. |
Boas práticas para evitar retrabalho
- Rings de implantação: comece com TI/piloto, depois grupos maiores. Isso revela políticas bloqueadoras cedo.
- Gestão via Intune: prefira o app Microsoft Store (new) em vez de instaladores avulsos; assegura atualizações e arquitetura correta.
- Monitoramento: crie alertas para eventos críticos do AppxDeployment e para falhas recorrentes do MSTeams.
- Documente exceções no proxy/SSL inspection para
.microsoft.com,.teams.microsoft.com,officecdn.microsoft.come CDNs relacionados. - Educação do usuário: oriente sobre fechar o Teams ao final do dia nas fases de migração, reduzindo conflitos de arquivo em uso (0x80073D02).
Quando e como envolver o suporte da Microsoft
Com Microsoft 365 Business Premium (ou planos equivalentes), o administrador do tenant pode abrir um chamado via Admin Center. Anexe:
- ZIP de logs do Teams (Ctrl + Alt + Shift + 1).
- Exportação dos eventos de AppxDeployment e AppxPackaging/OM correlacionados ao horário do erro.
- Relato do que já foi testado (atualizações, políticas, rede) e evidências de política do Teams.
Antes de abrir o chamado, vale conferir também Health → Service health para incidentes em curso que possam afetar a distribuição do novo cliente.
FAQ — dúvidas que aparecem sempre
O dispositivo é Windows 10/11 suportado, mas o banner pede “update your OS”. É bug?
Quase sempre é falta de WebView2/App Installer ou falha de MSIX. Atualize dependências e leia os eventos 0x80073…
Posso forçar por linha de comando?
Em ambientes liberados, winget pode instalar a versão da Store do Teams. Em produção, use Intune/Store para manter governança e atualização automática.
Limpar cache remove contas?
Se você excluir apenas Cache/GPUCache/databases, as credenciais permanecem. Evite apagar pastas de identidade sem necessidade.
E se o usuário não vê o toggle para o novo Teams?
Pode ser política herdada, atraso de replicação ou o cliente ainda não sincronizou. Verifique a política atribuída e peça uma reinicialização após ajustar.
Resumo acionável
Essência: quando o SO já cumpre os requisitos, os travamentos de migração para o novo Teams quase sempre estão ligados à Teams Update Policy do usuário ou a bloqueios de instalação MSIX no Windows. Os logs do AppxDeployment são o indicativo mais rápido do pré‑requisito exato que falhou. Execute o checklist, confirme as políticas, leia os eventos 0x80073…, e — se necessário — implante diretamente o “Microsoft Teams (work or school)” pela Store/Intune enquanto investiga.
Guia passo a passo consolidado
- Atualize o Windows e reinicie.
- Confirme WebView2 e App Installer instalados/atuais.
- Permita o novo Teams na política (Microsoft controlled/New Teams).
- Remova bloqueios de Store/MSIX (AllowAllTrustedApps, GPO de Store, antivírus).
- Limpe o cache do Teams e tente alternar novamente.
- Leia os logs em AppxDeployment e decodifique o código 0x80073…
- Implante diretamente pela Store/Intune se o push automático falhar.
- Abra chamado com logs anexados se o comportamento persistir.
Com esses passos, a grande maioria dos ambientes AAD‑joined consegue concluir a transição para o novo Microsoft Teams de forma estável e auditável.