Réparer la boucle « Teams needs an update » : guide complet Windows 11, Windows 10 & macOS

Symptômes persistants de mise à jour ? Ce guide exhaustif décrit les causes, fournit des solutions manuelles et automatisées et explique comment prévenir durablement la boucle « Teams needs an update » sur Windows 11, Windows 10 et macOS (Intel & Apple Silicon).

Sommaire

Boucle de mise à jour infinie de Microsoft Teams

Vue d’ensemble de la question

Depuis l’introduction du client unifié (dit « Nouvelle expérience », printemps 2024), de nombreux utilisateurs restent bloqués dans un cycle de mise à jour : le produit demande une nouvelle version, l’installeur se lance, puis la version obsolète revient immédiatement, empêchant parfois toute authentification (MFA, SSO, Conditional Access). Le phénomène touche à la fois les déploiements personnels et gérés par MDM/Intune ou JAMF Pro.

Pourquoi cette boucle se produit‑elle ?

  • Coexistence de plusieurs éditions : « Teams classique », « Teams (for personal use) » et le nouveau Unified Teams partagent certains répertoires, ce qui provoque des collisions de registre (Windows) ou de plist (macOS).
  • Droits insuffisants : l’ancienne édition peut s’auto‑installer dans %LocalAppData%. Sans privilèges d’administrateur, l’installateur du client unifié n’arrive pas à écraser les binaires existants.
  • Cache corrompu : les dossiers AppData/Library contiennent des manifests de version qui ne se mettent plus à jour lorsque le réseau ou un proxy d’entreprise bloque statics.teams.cdn.office.net.
  • Build OS trop ancien : certaines versions pré‑22H2 (Windows 10) ou macOS 11 ne répondent plus aux exigences signées du package V2.
  • Déploiement en double via GPO + Microsoft Store + Winget : trois flux parallèles installent trois SKU différentes qui s’écrasent tour à tour.

Réponse & solutions résumé

Axe d’actionDétails des étapesPlateforme
1. Lancer l’installateur en mode administrateurWindows : clic‑droit sur MsTeamsSetup.exe puis Exécuter en tant qu’administrateur.
macOS : ouvrir Terminal, exécuter :
sudo /Applications/Microsoft\ Teams.app/Contents/MacOS/Teams
Win / Mac
2. Désinstaller les anciennes éditions de TeamsPanneau de configuration ou Paramètres → désinstaller « Microsoft Teams », « Teams classique », « Teams (for personal use) ».
Supprimer ensuite les dossiers Program Files, Program Files (x86) ou Applications (Mac) contenant de vieilles versions.
Win / Mac
3. Nettoyer les données résiduellesWindows : effacer %AppData%\Microsoft\Teams, %LocalAppData%\Microsoft\Teams, %AppData%\Microsoft\TeamsInstaller.
macOS : supprimer ~/Library/Application Support/Microsoft/Teams et le cache associé.
Win / Mac
4. Vérifier qu’il ne reste qu’une seule versionTélécharger la dernière Unified Teams, copier l’exécutable (ou Teams.app) dans le répertoire standard, puis lancer cette version uniquement.Win / Mac
5. Déclencher l’ouverture du nouveau clientDepuis Outlook, cliquer sur « Partager dans Teams » ; accepter l’invite « Utiliser le nouveau Teams ».Win
6. Mettre l’OS à jourAppliquer toutes les mises à jour Windows ou installer le dernier macOS avant d’exécuter Teams ; certains packages refusent de s’installer sur des builds anciens.Win / Mac

Tutoriel détaillé pas à pas

Étape 1 – Préparation du système

  1. Désactiver le démarrage automatique : via Gestionnaire des tâches (onglet Démarrage) ou Préférences système › Utilisateurs & groupes › Éléments de connexion, désactiver toute entrée « Teams » pour éviter que l’application ne se relance pendant le nettoyage.
  2. Quitter totalement Teams : clic‑droit sur l’icône SysTray › Quitter. Sur macOS, ⌘ Q ou Ctrl ⌘ Q si la fenêtre est figée.

Étape 2 – Désinstallation complète

Microsoft propose deux canaux d’installation : MSI (entreprise) et EXE/PKG (auto‑update). Les deux laissent des artefacts différents :

  • MSI Machine‑Wide Installer : registre → HKLM\Software\Microsoft\Windows\CurrentVersion\Uninstall\{GUID}
  • EXE utilisateur : %LocalAppData%\Microsoft\Teams + tâche planifiée TeamsMachineInstaller

Désinstallez les deux si présents : la clé MSI empêche souvent la nouvelle version de se réinstaller proprement.

Étape 3 – Nettoyage des dossiers et du registre

Par souci d’exhaustivité, supprimez également :

%ProgramData%\Microsoft\Teams
%ProgramData%\Microsoft\TeamsUpdater
HKCU\Software\Microsoft\Office\Teams
HKLM\Software\Wow6432Node\Microsoft\Teams (si présent)

Sur macOS, vérifiez les fichiers ~/Library/Preferences/com.microsoft.teams.plist et ~/Library/Caches/com.microsoft.teams.

Étape 4 – Installation du client unifié

  1. Téléchargez l’installeur officiel :
    – Windows : package Teams_windows_x64.exe version 24124.1202.2996.1234 ou plus récent.
    – macOS : Teams_osx.pkg universel (Intel + ARM).
  2. Exécutez‑le en tant qu’administrateur (ou via sudo).
  3. Redémarrez la session (pas toujours nécessaire mais recommandé pour purger le cache App Model).

Étape 5 – Validation

Ouvrez Teams et allez dans « Aide › À propos › Version ». Vérifiez :

  • Numéro de version > 24000.
  • Chaîne « You’re using the new Teams ».
  • Aucune entrée « Teams classique » dans Paramètres › Applications installées.

Scripts et automatisation

Windows : script PowerShell officiel

# TeamsRemovalTool.ps1
Stop-Process -Name Teams -Force -ErrorAction SilentlyContinue
Get-WmiObject -Query "SELECT * FROM Win32_Product WHERE Name LIKE '%Teams%'" | ForEach-Object { $_.Uninstall() }
Remove-Item "$env:LOCALAPPDATA\Microsoft\Teams" -Recurse -Force -ErrorAction SilentlyContinue
# Supprime la tâche planifiée
SCHTASKS /Delete /TN "Teams Installer" /F

Déploiement Intune

  1. Créez un Win32 App pointant vers Teams_windows_x64.exe.
  2. Ajoutez un script de détection :
    Test-Path "$Env:ProgramFiles\Microsoft Office\root\VFS\ProgramFilesCommonX64\Microsoft Shared\Teams\current\teams.exe"
  3. Définissez la règle de redémarrage sur « App enforced » pour empêcher l’utilisateur de lancer l’ancienne version avant l’installation.

macOS : profil JAMF Pro

  • Utilisez la politique « Erase Application Support Files » pour com.microsoft.teams.
  • Ajoutez un script :
    pkgutil --forget com.microsoft.teams puis installer -pkg Teams_osx.pkg -target /

Analyse des journaux et validation avancée

  • Windows Event Viewer : Applications and Services Logs › Microsoft › Office › 16 › TeamsDesktopClient.
  • Fichier de log local :
    %AppData%\Microsoft\Teams\logs.txt – recherchez « Download update succeeded » suivi immédiatement de « Rollback to previous build ». Une telle séquence confirme la boucle.
  • macOS Console : filtre subsystem == "com.microsoft.teams".

Si la ligne UpdateMode=2 apparaît, cela signifie qu’une GPO force le canal Semi‑Annual et bloque la bascule. Mettez alors UpdateMode=0 ou supprimez la clé.

Scénarios d’entreprise et déploiement de masse

Paquetage MSI vs EXE

Le Teams Machine‑Wide Installer (MSI) est pratique pour les laboratoires universitaires, mais il ne pousse pas les mises à jour majeures du client unifié. Microsoft conseille désormais :

  • EXE (per‑user) pour les postes à usage individuel.
  • Winget ou Microsoft Store (winget install Microsoft.Teams) pour Windows 11 23H2+ : gère l’architecture ARM64 de Surface Pro X.
  • MSI + Office 365 Apps pour Entreprise uniquement si vous administrez la suite via Configuration Manager.

FAQ

Le nouveau Teams réinstalle l’ancien après chaque redémarrage : que faire ?

Une tâche planifiée « Teams Installer » demeure dans Task Scheduler › Microsoft › Office. Supprimez‑la puis réinstallez.
Le bouton Mettre à jour apparaît en boucle mais je n’ai pas les droits admin : contournement ?

Copiez l’exécutable Teams dans votre dossier utilisateur, ouvrez une invite PowerShell personnelle et lancez :
Start-Process .\Teams.exe -ArgumentList "--update" -Verb RunAs. Un administrateur devra approuver, mais l’opération se fait sans installateur système.
Comment éviter que Windows relance « Chat » (Teams pour usage personnel) ?

Paramètres Windows › Personnalisation › Barre des tâches › Chat → désactivé. Cela masque le backend ms-chat.exe.

Bonnes pratiques pour prévenir la réapparition

  1. Ne mélangez pas les canaux : choisissez Store ou MSI ou EXE, jamais deux à la fois.
  2. Surveillez les versions : script PowerShell simple :
    (Get-Item "C:\Program Files\Microsoft Teams\current\teams.exe").VersionInfo.FileVersion
  3. Proxy d’entreprise : whitelistez *.teams.microsoft.com et statics.teams.cdn.office.net.
  4. Tenez l’OS à jour : Windows 10 LTSC 2019 mourra fin 2029 mais ses API XAML ne sont plus testées contre Teams unifié.
  5. Documentez votre méthode : GPO ou Intune ? Stockez la version approuvée dans un partage réseau pour les rollbacks contrôlés.

Conclusion

La boucle de mise à jour Microsoft Teams résulte presque toujours d’une coexistence d’éditions ou d’un cache invalide. En supprimant systématiquement les vestiges, en installant le client unifié avec les droits adéquats puis en vérifiant qu’une seule édition subsiste, vous éliminez durablement le problème. Les scripts officiels, Winget et les MDM modernes accélèrent la procédure dans les environnements gérés. En suivant les recommandations ci‑dessus, vous garantissez à vos utilisateurs une expérience Teams stable, sans interruptions d’authentification ni pertes de productivité.

Sommaire