New Teams bloccato: guida completa per risolvere il passaggio da Classic Teams (policy, cache, prerequisiti)

Se il passaggio da Classic Teams a New Teams non funziona pur avendo i requisiti, la causa è quasi sempre cache corrotta, componenti mancanti o criteri aziendali che bloccano l’installer. Qui trovi una guida operativa, con controlli mirati, script e percorsi log per risolvere in modo sistematico.

Indice

Sintomi tipici

I segnali più frequenti che indicano un blocco dell’upgrade sono due:

  1. Banner di avviso: Classic Teams sarà presto disattivato. Per usare New Teams aggiorna il sistema operativo o contatta l’amministratore IT.
  2. Messaggio bloccante dopo lo switch a New Teams: L’organizzazione sta installando la nuova versione di Teams. Ti avviseremo quando sarà pronta.

Perché succede (cause più comuni)

AreaDettaglio
Prerequisiti di sistema incompletiWindows non completamente aggiornato; componenti come .NET Framework o Visual C++ Runtime assenti o obsoleti.
Cache o file corrottiResidui di installazioni precedenti o file locali danneggiati impediscono l’aggiornamento.
Criteri di amministrazionePolicy di Teams/Intune/Group Policy bloccano l’installazione di app attendibili. In particolare: impostazione AllowAllTrustedApps disabilitata.
Antivirus / FirewallIl download o l’esecuzione del bootstrapper viene intercettato o messo in quarantena.
Roll‑out gestito dall’organizzazioneÈ attiva la Teams Update Management Policy: il deployment è centralizzato e l’utente non può auto‑aggiornarsi.

Checklist rapida (ordine consigliato)

  1. Conferma i requisiti (Windows, aggiornamenti mensili, .NET 4.8.1, VC++ 2015–2022).
  2. Pulisci e reinstalla New Teams con il bootstrapper ufficiale.
  3. Analizza i log (Event Viewer, SquirrelTemp, log di Teams).
  4. Verifica policy e registro (UseNewTeamsClient, AllowAllTrustedApps e criteri Intune/GPO).
  5. Escludi interferenze (AV/Firewall, avvio in modalità provvisoria con rete).
  6. Valuta i workaround (Web Teams, app mobile) e apri ticket se necessario con log allegati.

Requisiti minimi e verifiche puntuali

Versione di Windows

  • Windows 10 22H2 build ≥ 19045.4561 oppure qualsiasi edizione supportata di Windows 11.
  • Assicurati che gli aggiornamenti qualitativi mensili siano installati.

Comandi utili (PowerShell con privilegi elevati):

# Versione e build
Get-ComputerInfo | Select-Object WindowsProductName, WindowsVersion, OsBuildNumber

Patch quality mensili (ultimi 30 giorni)

Get-HotFix | Sort-Object InstalledOn -Descending | Select-Object -First 10 Source, Description, HotFixID, InstalledOn 

Componenti applicativi

  • .NET Framework 4.8.1 (Release ≥ 533320).
  • Microsoft Visual C++ 2015–2022 Redistributable (x64 e x86 consigliati).

Verifica .NET:

# 4.8.1 = Release 533320 (o superiore)
(Get-ItemProperty "HKLM:\SOFTWARE\Microsoft\NET Framework Setup\NDP\v4\Full").Release

Verifica Visual C++:

$paths = @(
  "HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\*",
  "HKLM:\SOFTWARE\WOW6432Node\Microsoft\Windows\CurrentVersion\Uninstall\*"
)
Get-ItemProperty $paths |
  Where-Object { $_.DisplayName -match "Microsoft Visual C\+\+ 2015-2022 Redistributable" } |
  Select-Object DisplayName, DisplayVersion, Publisher

Pulizia profonda e reinstallazione di New Teams

Chiudi tutti i processi di Teams (anche eventuali msedgewebview2.exe associati) e segui questi passaggi.

1) Chiudi Teams (icona nell’area di notifica → Esci)
2) Termina eventuali processi residui da Gestione Attività:
   Teams.exe, Update.exe, Squirrel*, msedgewebview2.exe (solo istanze figlie di Teams)
3) Svuota le cache locali:
   %LocalAppData%\Microsoft\Teams          ← elimina contenuto
   %LocalAppData%\SquirrelTemp             ← elimina contenuto
   %AppData%\Microsoft\Teams               ← se presente da Classic, pulisci
4) Rimuovi cartelle di installazione utente (se esistono):
   %LocalAppData%\Programs\Microsoft Teams
   %ProgramData%\%User%\Teams              ← se presente, elimina
5) Scarica e lancia il bootstrapper di New Teams:
   Teamswindowsx64.exe
6) Completa l’accesso e verifica che l’interruttore “Nuova versione di Teams” sia attivo.

Nota: in ambienti gestiti, la reinstallazione potrebbe essere sovrascritta da criteri di aggiornamento centralizzato.

Dove cercare indizi: log ed eventi

  • Event ViewerApplication (Origine: Teams o Teams Installer). Filtra per Error/Warning nel periodo dell’installazione.
  • Cartella log: %LocalAppData%\SquirrelTemp (file tipo Teamsx64yyyy-mm-dd.log, SquirrelSetup.log).
  • Log AppX/Deployment: in Event Viewer sotto Microsoft-Windows-Appx\ e AppXDeployment-Server per eventuali errori 0x80073CF.

Pattern di errore utili da ricercare nei log:

0x80073CF9  Installazione AppX non riuscita (spazio/criteri)
0x80073D02  File in uso (riavvio necessario o cache non pulita)
0x80073CF3  Pacchetto dipendenze non soddisfatte

Policy di Teams, Intune e Group Policy da verificare

Teams Update Management

Se l’interruttore verso New Teams mostra “L’organizzazione sta installando la nuova versione di Teams” e la situazione non cambia entro 24 ore, quasi certamente il roll‑out centralizzato è attivo. Solo un amministratore Teams/Global Admin può modificarlo.

Controlli PowerShell (modulo Teams connesso):

# Verifica lo stato globale
Get-CsTeamsUpdateManagementPolicy -Identity Global

Consenti il download e l’installazione autonoma

Set-CsTeamsUpdateManagementPolicy -Identity Global -UseNewTeamsClient AllowDownloadAndInstall 

Nel Teams Admin Center, assicurati che la Teams update policy sia su Microsoft choice o User can opt in quando desideri permettere l’opt‑in dell’utente.

Consentire l’installazione di app attendibili

Per gli ambienti che distribuiscono New Teams tramite bootstrapper/MSIX, è fondamentale che il criterio Allow all trusted apps to install sia abilitato. Il controllo tipico avviene attraverso criteri Computer Configuration → Administrative Templates → Windows Components → App Package Deployment.

Registro (verifica e solo in testing, non modificare in produzione senza GPO/Intune):

  • HKLM\SOFTWARE\Policies\Microsoft\Windows\Appx\AllowAllTrustedApps = 1
  • (In alcune configurazioni vendor) HKLM\SOFTWARE\Microsoft\Teams\AllowAllTrustedApps = 1

PowerShell di verifica:

$keys = @(
 "HKLM:\SOFTWARE\Policies\Microsoft\Windows\Appx",
 "HKLM:\SOFTWARE\Microsoft\Teams"
)
foreach($k in $keys){
  if(Test-Path $k){
    "{0}\AllowAllTrustedApps = {1}" -f $k, (Get-ItemProperty $k -ErrorAction SilentlyContinue).AllowAllTrustedApps
  } else {
    "{0} non presente" -f $k
  }
}

Best practice: applica/gestisci questi valori via Group Policy o Intune (Configuration Profiles o Settings Catalog) per coerenza e compliance.

Antivirus, Firewall e ispezione TLS

Durante il download e l’installazione, alcuni motori di sicurezza possono bloccare l’eseguibile o l’MSIX. Per testare:

  • Disabilita temporaneamente funzionalità di content inspection o application control.
  • Inserisci eccezioni per cartelle e processi di Teams durante l’installazione.
  • Verifica la raggiungibilità dei domini essenziali (senza inserire link): teams.microsoft.com, login.microsoftonline.com, officecdn.microsoft.com, azureedge.net, skype.com, microsoft.com.

Importante: l’ispezione SSL/TLS su questi endpoint può rompere il bootstrap. Se attiva, escludi gli host di Microsoft 365 dal SSL interception.

Test senza interferenze

  • Avvio in modalità provvisoria con rete: riduce all’osso i driver/servizi, utile per distinguere conflitti di terze parti.
  • Avvio pulito (msconfig) e nuovo profilo utente locale: aiuta a isolare problemi di profilo.
  • Rete di test (hotspot o guest): escude filtri proxy/NGFW aziendali come causa.

Workaround per continuità operativa

  • Web Teams: utilizza l’interfaccia web (digitando manualmente l’indirizzo del servizio nella barra del browser) se il client desktop è bloccato.
  • App mobile per iOS/Android: utile per riunioni urgenti in attesa della risoluzione sul PC.

Aprire una richiesta a Microsoft con evidenze complete

  1. Dal Microsoft 365 Admin Center → SupportNuova richiesta.
  2. Allega:
    • File %LocalAppData%\SquirrelTemp\Teamsx64yyyy-mm-dd.log e SquirrelSetup.log.
    • Eventi esportati da Application e AppXDeployment-Server.
    • Report di diagnostica TeamsDiag Collector se disponibile nella tua organizzazione.

Pacchetto di diagnostica “pronto all’uso” (script)

Esegui come amministratore per raccogliere rapidamente i log più utili in un archivio ZIP.

$ErrorActionPreference = "SilentlyContinue"
$ts = Get-Date -Format "yyyyMMdd_HHmmss"
$dest = "$env:USERPROFILE\Desktop\TeamsDiag_$ts"
New-Item -ItemType Directory -Path $dest | Out-Null

\$paths = @(
"\$env\:LOCALAPPDATA\SquirrelTemp",
"\$env\:LOCALAPPDATA\Microsoft\Teams\current",
"\$env\:APPDATA\Microsoft\Teams\logs.txt"
)

foreach(\$p in \$paths){
if(Test-Path \$p){ Copy-Item \$p -Destination \$dest -Recurse -Force }
}

Eventi applicativi e AppX

wevtutil epl Application "\$dest\Application.evtx"
wevtutil epl Microsoft-Windows-AppXDeploymentServer/Operational "\$dest\AppXDeployment.evtx"

Compress-Archive -Path "\$dest\*" -DestinationPath "\$dest.zip" -Force
Write-Host "Raccolta completata: \$dest.zip" 

Domande frequenti (FAQ)

Posso forzare l’aggiornamento anche se vedo “L’organizzazione sta installando…”?

No, se il roll‑out è gestito centralmente dalla Teams Update Management Policy, l’utente non può scavalcarlo. Va richiesto a un amministratore di modificare la policy (ad es. AllowDownloadAndInstall o User can opt in).

Il banner chiede di aggiornare Windows ma sono già su Windows 11. Che faccio?

Verifica gli aggiornamenti qualitativi del mese, .NET 4.8.1 e i pacchetti Visual C++. Spesso il blocco non è il sistema operativo ma dipendenze mancanti. Pulisci la cache e reinstalla come indicato.

Serve WebView2?

Il nuovo client si appoggia al runtime WebView2 del sistema. Normalmente è fornito/aggiornato automaticamente; se assente o bloccato, l’installer può fallire. In ambienti restrittivi, valuta di distribuirlo con gli strumenti di gestione software aziendale.

Qual è la differenza tra reinstallare e riparare?

La riparazione non sempre rimuove cache e componenti Squirrel/AppX rimasti in stato incoerente. La reinstallazione pulita elimina residui e ricrea l’ambiente, riducendo i fallimenti “già presente/in uso”.

Posso cambiare i valori di registro manualmente?

Per test di laboratorio sì, ma in produzione è preferibile applicare i criteri via GPO o Intune. Modifiche dirette al registro possono essere sovrascritte dai motori di gestione o non risultare conformi.

Checklist finale (in 10 minuti)

  1. Conferma OS e patch → Get-ComputerInfo e Get-HotFix.
  2. Controlla .NET e VC++ presenti.
  3. Pulisci %LocalAppData%\Microsoft\Teams e %LocalAppData%\SquirrelTemp.
  4. Reinstalla con Teamswindowsx64.exe.
  5. Se compare il messaggio sull’organizzazione: verifica UseNewTeamsClient (Teams Admin Center/PowerShell).
  6. Se l’installazione fallisce: leggi gli eventi AppX e i log Squirrel; controlla AllowAllTrustedApps.
  7. Escludi interferenze AV/Firewall; se serve prova in modalità provvisoria con rete.

Appendice: codici d’errore AppX più comuni e rimedi

CodiceSignificatoRimedio suggerito
0x80073CF9Failure generico installazione AppXControlla spazio e criteri AppX; abilita AllowAllTrustedApps; riprova con cache pulita.
0x80073D02File in usoChiudi processi residui; riavvia; ripeti installazione.
0x80073CF3Dipendenze non soddisfatteInstalla/aggiorna WebView2, VC++ o altre dipendenze segnalate dai log.
0x800704C7Operazione annullataVerifica AV/proxy; rilancia l’installer come amministratore.

Esempi di comandi utili (raccolta completa)

Policy Teams:

# Leggi policy globali
Get-CsTeamsUpdateManagementPolicy -Identity Global

Consenti opt-in e installazione

Set-CsTeamsUpdateManagementPolicy -Identity Global -UseNewTeamsClient AllowDownloadAndInstall 

Verifica criteri AppX su Windows:

reg query "HKLM\SOFTWARE\Policies\Microsoft\Windows\Appx" /v AllowAllTrustedApps

Test connettività di base:

Test-NetConnection teams.microsoft.com -Port 443

Individuare processi Teams residui:

Get-Process teams -ErrorAction SilentlyContinue | Select-Object Name, Id, Path

Raccomandazioni finali

  • La radice del problema raramente è la versione di Windows in sé: molto più spesso sono componenti mancanti, cache corrotta o policy restrittive.
  • Affronta la diagnosi in ordine: requisiti OS → pulizia/reinstallazione → policy/registro → log.
  • Se l’update è gestito centralmente, l’utente non può intervenire: serve una modifica alla Teams Update Management Policy.

Riepilogo operativo (one‑pager stampabile)

  1. Requisiti: Win10 22H2 (≥ 19045.4561) o Win11 + patch del mese + .NET 4.8.1 + VC++ 2015–2022.
  2. Pulizia: elimina %LocalAppData%\Microsoft\Teams, %AppData%\Microsoft\Teams (se presente), %LocalAppData%\SquirrelTemp.
  3. Reinstallazione: esegui Teamswindowsx64.exe.
  4. Policy:
    • Teams Update Management → Microsoft choice o User can opt in.
    • Registro: AllowAllTrustedApps=1 (policy AppX).
  5. Log: Event Viewer (Application, AppXDeployment-Server), %LocalAppData%\SquirrelTemp.
  6. Se bloccato dall’organizzazione: coinvolgi l’amministratore Teams/Global con gli output dei comandi e i log.

Con questa procedura strutturata riduci il tempo di diagnosi, elimini le cause più probabili e ottieni evidenze chiare per eventuale escalation.

Indice