Résoudre les problèmes d’installation et de mise à jour de Microsoft Teams sur WindowsTroubleshoot Microsoft Teams installation and update issues on Windows

Cet article fournit des instructions sur la façon de diagnostiquer et de résoudre les problèmes d’installation et de mise à jour pour l’application de client de bureau Teams exécutée sur Windows.This article provides guidance for how to diagnose and troubleshoot installation and update issues for the Teams desktop client app running on Windows.

Vérifier si Teams est correctement mis à jourCheck whether Teams is updated successfully

Suivez ces étapes pour vérifier si une mise à jour de Teams est correctement installée.Follow these steps to check whether a Teams update is successfully installed.

  1. Dans Teams, sélectionnez votre image de profil, puis accédez à À propos > Version.In Teams, select your profile picture, and then click About > Version.
  2. Dans le même menu, cliquez sur Rechercher les mises à jour.On the same menu, click Check for updates.
  3. Attendez que la bannière située en haut de l’application indique qu’une « actualisation » de Teams est nécessaire.Wait for the banner at the top of the app to indicate that a “refresh” of Teams is needed. Le lien doit apparaître environ une minute plus tard, car ce processus télécharge la nouvelle version de Teams.The link should be shown about a minute later as this process downloads the new version of Teams. La bannière vous indique également si vous utilisez déjà la version la plus récente, auquel cas aucune mise à jour n’est nécessaire.The banner also lets you know if you’re already running the latest version in which case, no update is necessary.
  4. Cliquez sur le lien actualiser dans la bannière.Click the refresh link in the banner.
  5. Patientez jusqu’à ce que Teams redémarre, puis répétez l’étape 1 pour vérifier si l’application est mise à jour.Wait until Teams restarts, and then repeat step 1 to see whether the app is updated.

Si vous voyez un message d’échec ou si le numéro de version est le même que dans l’étape 4, le processus de mise à jour a échoué.If you see a failure message or if the version number is the same as in step 4, the update process failed.

Résoudre les problèmes d’installation et de mise à jourTroubleshoot installation and update issues

Résoudre les problèmes d’installationTroubleshoot installation issues

Lors de l’installation de Teams, le programme d’installation de Teams enregistre la séquence d’événements sur %LocalAppData%\SquirrelTemp\SquirrelSetup.log.When Teams is installed, the Teams installer logs the sequence of events to %LocalAppData%\SquirrelTemp\SquirrelSetup.log. La première chose à rechercher est le message d’erreur ou la pile d’appels à l’approche de la fin du journal.The first thing to look for is an error message or a call stack near the end of the log. Notez que les piles d’appels au début du journal ne signifient peut-être pas qu’il existe un problème d’installation.Note that call stacks at the beginning of the log may not mean that an installation issue exists. Il peut être plus facile de comparer votre journal au journal d’une installation réussie (même sur un autre ordinateur) pour voir ce qui est prévu.It can be easier to compare your log against the log from a successful installation (even on another machine) to see what's expected.

Si SquirrelSetup.log n’indique pas la cause ou si vous avez besoin d’informations supplémentaires pour résoudre le problème, voir Collecter et analyser des journaux d’applications et systèmes.If SquirrelSetup.log doesn't indicate the cause or if you need more information to troubleshoot the issue, see Collect and analyze application and system logs.

Résoudre les problèmes de mise à jourTroubleshoot update issues

Lorsque Teams est correctement installé, l’emplacement du journal passe de %LocalAppData%\SquirrelTemp à %AppData%\Microsoft\Teams.When Teams is successfully installed, the log location switches from %LocalAppData%\SquirrelTemp to %AppData%\Microsoft\Teams. À cet emplacement figurent deux fichiers journaux intéressants, SquirrelSetup.log et logs.txt.At this location, there are two log files of interest, SquirrelSetup.log and logs.txt.

  • Le fichier SquirrelSetup.log à cet emplacement est écrit par Update.exe, lequel est un exécutable qui révise l’application Teams.The SquirrelSetup.log file at this location is written by Update.exe, which is an executable that services the Teams app.
  • Le fichier logs.txt est utilisé par l’application Teams (spécifiquement Teams.exe) pour enregistrer les événements importants de l’application.The Logs.txt file is used by the Teams app (specifically Teams.exe) to record significant application events. Il contient généralement des informations d’échec.It will likely contain failure information.

Ces fichiers journaux contiennent des informations d’identification personnelle (PII) et ne sont donc pas envoyés à Microsoft.These log files contain personally identifiable information (PII) and so they're not sent to Microsoft.

Teams peut démarrer automatiquement le processus de mise à jour (selon la stratégie), ou les utilisateurs peuvent rechercher manuellement les mises à jour en accédant à leur image de profil > Rechercher les mises à jour.Teams can automatically start the update process (depending on the policy) or users can manually check for updates by going to their profile picture > Check for updates. Les deux méthodes utilisent la séquence d’événements suivante.Both methods use the following sequence of events.

  1. Rechercher les mises à jour.Check for updates. Teams effectuent une requête sur le Web et inclut la version actuelle de l’application et les informations relatives à l’anneau de déploiement.Teams makes a web request and includes the current app version and deployment ring information. L’objectif de cette étape est d’obtenir le lien de téléchargement.The goal of this step is to get the download link. Un échec à cette étape est enregistré dans logs.txt.A failure at this step is logged in Logs.txt.
  2. Télécharger la mise à jour..Download update. Teams télécharge la mise à jour à l’aide du lien de téléchargement obtenu à partir de l’étape 1.Teams downloads the update by using the download link obtained from step 1. Une fois le téléchargement terminé, Teams appelle Update.exe pour préparer le téléchargement.When the download is complete, Teams calls Update.exe to stage the download. Un échec de téléchargement est également consigné dans logs.txt.A download failure is also logged in Logs.txt.
  3. Mettez à jour la mise à jour.Stage the update. Le contenu téléchargé est vérifié et décompressé dans un dossier intermédiaire, %LocalAppData%\Microsoft\Teams\stage), lequel est exécuté par Update.exe.The downloaded content is verified and unpacked into an intermediate folder, %LocalAppData%\Microsoft\Teams\stage), which is done by Update.exe. Les échecs à cette étape sont enregistrés dans SquirrelTemp.log.Failures at this step are logged in SquirrelTemp.log.
  4. Installez la mise à jour.Install the update. Plusieurs méthodes s’offrent à vous pour démarrer Teams.There are multiple ways to start Teams. Le système démarre automatiquement Teams lorsqu’un utilisateur se connecte ou vous pouvez démarrer Teams à l’aide d’un raccourci.The system automatically starts Teams when a user logs in or you can start Teams through a shortcut. Au cours de cette étape, Update.exe vérifie la présence du dossier intermédiaire, vérifie de nouveau le contenu et effectue les opérations de fichier pour annuler l’exécution de l’application.In this step, Update.exe checks for the presence of the staging folder, verifies the content again, and performs file operations to un-stage the app. L’ancien dossier d’application dans %LocalAppData%\Microsoft\Teams\current est sauvegardé sur %LocalAppData%\Microsoft\Teams\previous et le dossier stage est renommé « actuel ».The old application folder in %LocalAppData%\Microsoft\Teams\current is backed up to %LocalAppData%\Microsoft\Teams\previous and the stage folder is renamed to "current". Les échecs à cette étape sont enregistrés dans SquirrelTemp.log.Failures at this step are logged in SquirrelTemp.log.

Si SquirrelTemp.log ou logs.txt ne contiennent pas assez d’informations pour déterminer la cause sous-jacente et que vous avez besoin d’informations supplémentaires pour résoudre le problème, accédez à Collecter et analyser les journaux des applications et du système.If SquirrelTemp.log or Logs.txt don't contain sufficient information to determine the underlying cause and you need more information to troubleshoot the issue, go to Collect and analyze application and system logs.

Collecter et analyser les journaux des applications et du systèmeCollect and analyze application and system logs

Cette section explique comment recueillir et analyser les journaux des applications et du système afin d’obtenir des informations plus complètes pour résoudre le problème.This section describes how to collect and analyze application and system logs to get more comprehensive information to troubleshoot the issue. Vous utiliserez les outils Sysinternals pour effectuer ces étapes.You'll use Sysinternals tools to complete these steps. Pour plus d’informations, voir Windows Sysinternals.To learn more, see Windows Sysinternals.

Collectez les journauxCollect logs

  1. Téléchargez les outils Sysinternals.Download the Sysinternals tools.

  2. Extraire le fichier zip dans le dossier %TEMP% sur votre disque local.Extract the zip file to the %TEMP% folder on your local drive.

  3. Ouvrez une invite de commandes avec élévation de privilèges, puis procédez comme suit :Open an elevated command prompt, and then do the following:

    1. Pour accéder à votre dossier TEMP, exécutez la commande suivante :Run the following to go to your TEMP folder:

      cd /d %TEMP%
      
    2. Copiez les journaux de configuration et d’application.Copy the setup and application logs. Notez que certains de ces journaux peuvent ne pas être présents en fonction du point d’échec.Note that depending on the point of failure, some of these logs may not be present.

      copy %LocalAppData%\SquirrelTemp\SquirrelSetup.log SquirrelSetup.log
      copy %AppData%\Microsoft\Teams\logs.txt logs.txt
      copy %LocalAppData%\Microsoft\Teams\SquirrelSetup.log SquirrelSetup_Teams.log
      
    3. Exécutez la commande suivante pour capturer les poignées ouvertes.Run the following to capture the open handles.

      handle > handles.txt
      
    4. Exécutez la commande suivante pour capturer les dll ouvertes.Run the following to capture the opened DLLs.

      listdlls -v Teams > dlls.txt
      
    5. Exécutez la commande suivante pour capturer les pilotes en cours d’exécution.Run the following to capture the drivers that are running.

      driverquery /v > driverquery.txt
      
    6. Exécutez la commande suivante pour capturer les listes de contrôle d’accès (ACL) du dossier Teams.Run the following to capture the access control lists (ACLs) of the Teams folder.

      icacls %LOCALAPPDATA%\Microsoft\Teams /save icacls.txt /T
      

Analyser les journaux (pour les utilisateurs avancés)Analyze logs (for advanced users)

La mise à jour qui a échoué peut entraîner un comportement imprévisible de l’application.A failed update can result in unpredictable app behavior. Par exemple, il est possible que les utilisateurs ne puissent pas quitter Teams, aient une version caduque de Teams ou ne puissent pas démarrer Teams.For example, users may be unable to exit Teams, have a stale version of Teams, or can't start Teams. Si vous rencontrez un problème lors d’une mise à jour, le premier emplacement pour rechercher la cause est SquirrelTemp.log.If you experience an issue during an update, the first place to look to find the cause is SquirrelTemp.log. Voici les différents types d’échecs de mise à jour, qui sont répertoriés du plus courant au moins courant, et comment les analyser et les résoudre à l’aide des journaux.Here are the different types of update failures, listed from most common to least common, and how to analyze and troubleshoot them using logs.

Impossible de quitter TeamsUnable to exit Teams

Au fur et à mesure que Teams détermine qu’il doit se mettre en à jour avec une version plus récente, il télécharge et passe à la nouvelle application, puis attend une opportunité pour redémarrer la prochaine fois que l’ordinateur est inactif.As Teams determines that it needs to update itself to a newer version, it downloads and stages the new app, and then waits for an opportunity to restart itself the next time the machine is idle. Un problème courant lors de ce processus est qu’un autre processus ou un pilote de système de fichiers verrouille le processus Teams.exe, lequel empêche Teams.exe de quitter.A common issue during this process is when another process or a file system driver locks up the Teams.exe process, which prevents Teams.exe from exiting. Par conséquent, l’application Teams ne peut pas être remplacée par l’application nouvellement téléchargée et intermédiaire.As a result, the Teams app can't be replaced by the newly-downloaded and staged app.

Conseils de dépannage :Troubleshooting tips:

  • Pour confirmer qu’il s’agit du problème que vous rencontrez, quittez Teams (cliquez avec le bouton droit sur Teams dans la barre des tâches, puis cliquez sur Quitter).To confirm that is the issue that you're experiencing, quit Teams (right-click Teams on the task bar, and then click Quit). Ouvrez ensuite le Gestionnaire des tâches dans Windows pour voir si une instance de Teams est encore en cours d’exécution.Then, open Task Manager in Windows to see whether an instance of Teams is still running.
  • Si vous n’utilisez pas l’ordinateur sur lequel vous rencontrez ce problème, examinez le fichier SquirrelTemp.log collecté à partir de l’ordinateur qui rencontre ce problème et recherchez l’entrée « Programme : impossible de terminer l’opération dans le journal ».If you’re not on the computer that's having this issue, inspect the SquirrelTemp.log collected from the computer that's experiencing this issue and look for a "Program: Unable to terminate the process in the log" entry.
  • Pour déterminer ce qui empêche Teams.exe de quitter, consultez les journaux dll.txt et handles.txt.To determine what's preventing Teams.exe from exiting, look at the Dlls.txt and Handles.txt logs. Ceux-ci indiquent les processus qui ont empêché Teams de quitter.These tell you the processes that prevented Teams from exiting.
  • Un autre coupable de pouvoir empêcher Teams de quitter est le pilote de filtre de système de fichiers en mode noyau.Another culprit that can prevent Teams from exiting is the kernel-mode file system filter driver. Utilisez l’outil SysInternals, ProcDump, pour collecter le vidage du processus en mode noyau en exécutant procdump -mk <pid>, où est l’ID de processus obtenu à partir du Gestionnaire des tâches.Use the SysInternals tool, ProcDump, to collect the kernel-mode process dump by running procdump -mk <pid>, where is the process ID obtained from Task Manager. Vous pouvez également inspecter le fichier journal Driverquery.txt pour afficher les pilotes de filtre actifs qui peuvent interférer avec Teams.You can also inspect the Driverquery.txt log file to see the active filter drivers that may interfere with Teams.
  • Pour récupérer à partir de cet état, redémarrez l’ordinateur.To recover from this state, restart the computer.

Autorisations d’accès aux fichiersFile permissions

Teams crée un certain nombre de sous-dossiers et de fichiers dans le profil de l’utilisateur tout au long du processus d’installation et de mise à jour.Teams creates a number of subfolders and files in the user's profile throughout the installation and update process. Étant donné que l’application et le programme de mise à jour sont exécutés en tant qu’utilisateurs non élevés, les autorisations de lecture et d’écriture doivent être accordées sur les dossiers suivants :Because the app and the updater runs as a non-elevated user, read and write permissions must be granted on the following folders:

DossierFolder UtilisateurUsed by
%LocalAppData%\SquirrelTemp%LocalAppData%\SquirrelTemp Programme d’installation de Teams (par exemple, Teams_Windows_x64.exe) lors de la phase d’installationTeams installer (for example, Teams_Windows_x64.exe) during installation phase
%LocalAppData%\Microsoft\Teams%LocalAppData%\Microsoft\Teams Mise à jour de Teams (Update.exe) pour extraire et organiser le package d’application pendant le processus de mise à jourTeams updater (Update.exe) to extract and stage the app package during update process
%AppData%\Microsoft\Teams%AppData%\Microsoft\Teams Application Teams (Teams.exe) pour enregistrer les paramètres, l’état de l’application et le package de mise à jour téléchargé (pré-intermédiaire)Teams app (Teams.exe) to save settings, app states, and the (pre-staged) downloaded update package

Si l’accès à Teams est refusé parce qu’il ne peut pas écrire dans un fichier, il est possible qu’une autre application logicielle interfère ou qu’une entrée de descripteur de sécurité limite l’accès en écriture à un dossier.If Teams is denied access because it can't write to a file, another software application may be interfering or a security descriptor entry may be limiting write access to a folder.

Conseils de dépannage :Troubleshooting tips:

  • Recherchez la preuve « accès refusé » dans SquirrelTemp.log ou logs.txt.Look for "access denied" evidence in SquirrelTemp.log or Logs.txt. Vérifiez ces fichiers pour voir s’il y a eu une tentative d’écriture dans un fichier qui a échoué.Check these files to see whether there was an attempt to write to a file that failed.
  • Ouvrez icacls.txt et recherchez l’entrée de contrôle d’accès (ACE) effective qui bloque les opérations d’écriture d’un utilisateur qui n’est pas un administrateur. Il s’agit généralement de l’une des entrées DACL.Open Icacls.txt and look for the effective access control entry (ACE) that blocks write operations by a user who is not an admin. Typically, this is in one of the DACL entries. Pour plus d’informations, voir la documentation icacls.For more information, see the icacls documentation.

Fichier endommagéFile corrupted

Dans certains cas, le logiciel de chiffrement peut modifier les fichiers dans le dossier %LocalAppData%\Microsoft\Teams, ce qui peut empêcher le démarrage de Teams.In some cases, encryption software can change files in the %LocalAppData%\Microsoft\Teams folder, which can prevent Teams from starting. Cela peut se produire à tout moment, même si l’application n’est pas mise à jour.This can happen at any time, even when the app isn't being updated. Malheureusement, lorsqu’un fichier est endommagé, la seule façon de récupérer cet état est de désinstaller et de réinstaller Teams.Unfortunately, when a file is corrupted, the only way to recover from this state is to uninstall and re-install Teams.

Notes

Si vous ne parvenez pas à déterminer la cause sous-jacente du problème à l’aide de l’une de ces étapes, vous souhaiterez peut-être effectuer une sessionProcess monitor.If you can't determine the underlying cause of the issue by using any of these steps, you may want to try a Process Monitor session. Process Monitor est un outil Sysinternals qui enregistre l’accès au registre et au système de fichiers.Process Monitor is a Sysinternals tool that records access to the registry and file system.