Behandeln von Problemen bei der klassischen Microsoft Teams-Installation und -Aktualisierung unter Windows

Dieser Artikel enthält Anleitungen zu Diagnose und Problembehandlung bei Installations- und Updateproblemen für die Teams-Desktopclient-App unter Windows. Weitere Informationen zur Problembehandlung finden Sie unter Problembehandlung für Teams.

[! Wichtig]

Dieser Artikel gilt nur für klassische Microsoft Teams. Informationen zu neuen Teams finden Sie unter Beheben von Installationsproblemen im neuen Teams-Client.

Überprüfen, ob Teams erfolgreich aktualisiert wurde

Führen Sie die folgenden Schritte aus, um zu überprüfen, ob Teams erfolgreich installiert wurde.

  1. Wählen Sie in Teams die Auslassungspunkte (...) neben Ihrem Profilbild aus, und klicken Sie dann auf Info>Version. Es wird ein Banner angezeigt, das Ihre aktuelle Teams-Version und den Zeitpunkt der letzten Aktualisierung anzeigt. Beispiel: Sie haben Microsoft Teams Version 1.5.00.3806 (64-Bit)-E. Es wurde zuletzt am 16.02.2022 aktualisiert.
  2. Öffnen Sie das Menü mit den Auslassungspunkten erneut, und klicken Sie auf Nach Updates suchen.
  3. Warten Sie, bis oben in der App das Banner angezeigt wird, dass darauf hinweist, dass eine „Aktualisierung“ von Teams erforderlich ist. Der Link sollte ungefähr eine Minute später angezeigt werden, während dieser Vorgang die neue Version von Teams herunterlädt. Das Banner informiert Sie auch darüber, ob Sie bereits die neueste Version ausführen. In diesem Fall ist keine Aktualisierung erforderlich.
  4. Klicken Sie im Banner auf den Link "Aktualisieren".
  5. Warten Sie, bis Teams neu gestartet wird, und wiederholen Sie dann Schritt 1, um zu überprüfen, ob die App aktualisiert wurde.

Wenn eine Fehlermeldung angezeigt wird oder die Versionsnummer mit der in Schritt 4 identisch ist, ist der Updatevorgang fehlgeschlagen.

Problembehandlung bei Problemen mit Installation und Update

Behandeln von Installationsproblemen

Wenn Teams installiert ist, protokolliert das Teams-Installationsprogramm die Abfolge der Ereignisse in%LocalAppData%\SquirrelTemp\SquirrelSetup.log. Zuerst sollten Sie nach einer Fehlermeldung oder einer Anrufliste am Ende des Protokolls suchen. Beachten Sie, dass Aufruflisten am Anfang des Protokolls möglicherweise nicht bedeuten, dass ein Installationsproblem vorliegt. Es kann einfacher sein, Ihr Protokoll mit einem Protokoll einer erfolgreichen Installation (ggf. auf einem anderen Computer) zu vergleichen, um zu sehen, was zu erwarten ist.

Wenn %LocalAppData%\SquirrelTemp\SquirrelSetup.log die Ursache nicht angegeben ist oder Sie weitere Informationen zur Problembehandlung benötigen, lesen Sie Sammeln und Analysieren von Anwendungs- und Systemprotokollen.

Behandeln von Problemen beim Update

Wenn Teams erfolgreich installiert wurde, wechselt der Protokollspeicherort von %LocalAppData%\SquirrelTemp zu %LocalAppData%\Microsoft\Teams\SquirrelSetup.log. Eine weitere interessante Protokolldatei ist %AppData%\Microsoft\Teams\logs.txt.

  • Die %LocalAppData%\Microsoft\Teams\SquirrelSetup.log-Datei wird von Update.exe geschrieben, einer ausführbaren Datei, die die Teams-App unterstützt.
  • Die %AppData%\Microsoft\Teams\logs.txt-Datei wird von der Teams-App (insbesondere Teams.exe) verwendet, um wichtige Anwendungsereignisse aufzuzeichnen. Sie enthält wahrscheinlich Fehlerinformationen.

Diese Protokolldateien enthalten personenbezogene Informationen (Personally Identifiable Information, PII) und werden daher nicht an Microsoft gesendet.

Teams kann den Aktualisierungsvorgang automatisch starten (je nach Richtlinie) oder Benutzer können manuell nach Aktualisierungen suchen, indem sie zum Menü mit den Auslassungspunkten (...) neben ihrem Profilbild gehen und Nach Aktualisierungen suchen auswählen. Beide Methoden verwenden die folgende Ereignissequenz.

  1. Nach Updates suchen. Teams erstellt eine Webanforderung und schließt die aktuelle App-Version sowie Informationen zum Bereitstellungsring ein. Das Ziel dieses Schritts besteht darin, den Downloadlink abzurufen. Ein Fehler bei diesem Schritt wird in %AppData%\Microsoft\Teams\logs.txt protokolliert.
  2. Update herunterladen. Teams lädt das Update mithilfe des in Schritt 1 abgerufenen Downloadlinks herunter. Wenn der Download abgeschlossen ist, ruft Teams Update.exeauf um den Download bereitzustellen. Ein Downloadfehler wird auch in %AppData%\Microsoft\Teams\logs.txt protokolliert.
  3. Updates bereitstellen. Der heruntergeladene Inhalt wird von Update.exe überprüft und in einem Zwischenordner %LocalAppData%\Microsoft\Teams\stage entpackt. Fehler bei diesem Schritt werden in %LocalAppData%\Microsoft\Teams\SquirrelSetup.log protokolliert.
  4. Update installieren. Es gibt mehrere Möglichkeiten, Teams zu starten. Teams wird automatisch gestartet, wenn sich ein Benutzer anmeldet, oder Sie können Teams über eine Verknüpfung starten. In diesem Schritt überprüft Update.exe das Vorhandensein des Bereitstellungsordners, überprüft den Inhalt erneut und führt Dateivorgänge aus, um die Bereitstellung der App aufzuheben. Der alte Anwendungsordner in %LocalAppData%\Microsoft\Teams\current wird in %LocalAppData%\Microsoft\Teams\previous gesichert und der Bereitstellungsordner wird incurrent umbenannt. Fehler bei diesem Schritt werden in %LocalAppData%\Microsoft\Teams\SquirrelSetup.log protokolliert.

Wenn %LocalAppData%\Microsoft\Teams\SquirrelSetup.log oder %AppData%\Microsoft\Teams\logs.txt nicht genügend Informationen enthalten, um die zugrundeliegende Ursache zu ermitteln, und Sie weitere Informationen zur Behebung des Problems benötigen, gehen Sie zu Sammeln und Analysieren von Anwendungs- und Systemprotokollen.

Erfassen und Analysieren von Anwendungs- und Systemprotokollen

In diesem Abschnitt wird beschrieben, wie Anwendungs- und Systemprotokolle erfasst und analysiert werden, um umfassendere Informationen zur Problembehandlung zu erhalten. Sie verwenden die Sysinternals-Tools, um diese Schritte auszuführen. Weitere Informationen hierzu finden Sie unter Windows Sysinternals.

Protokolle erfassen

  1. Laden Sie die Sysinternals-Tools herunter.

  2. Extrahieren Sie die ZIP-Datei in den %Temp%-Ordner auf dem lokalen Laufwerk.

  3. Öffnen Sie eine Eingabeaufforderung mit erhöhten Rechten, und gehen Sie dann folgendermaßen vor:

    1. Führen Sie Folgendes aus, um zu Ihrem %Temp%-Ordner zu gelangen:

      cd /d %Temp%
      
    2. Kopieren Sie die Setup- und Anwendungsprotokolle. Je nachdem, wo der Fehlerauftritt, sind einige dieser Protokolle möglicherweise nicht vorhanden.

      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. Führen Sie die folgenden Schritte aus, um die geöffneten Handles aufzuzeichnen.

      handle > handles.txt
      
    4. Führen Sie die folgenden Schritte aus, um die geöffneten DLLs aufzuzeichnen.

      listdlls -v Teams > dlls.txt
      
    5. Führen Sie die folgenden Schritte aus, um die laufenden Treiber zu erfassen.

      driverquery /v > driverquery.txt
      
    6. Führen Sie die folgenden Schritte aus, um die ACLs (Access Control Lists) des Ordners "Teams" zu erfassen.

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

Protokolle analysieren (für fortgeschrittene Benutzer)

Eine fehlgeschlagene Aktualisierung kann zu einem unvorhersehbaren App-Verhalten führen. So können Benutzer beispielsweise Teams nicht mehr beenden, verwenden weiter die veraltete Version von Teams oder können Teams nicht starten. Wenn während eines Updates ein Problem auftritt, ist %LocalAppData%\SquirrelTemp\SquirrelSetup.log der erste Ort, an dem Sie nach der Ursache suchen müssen. Nachfolgend werden die verschiedenen Arten von Updatefehlern, vom häufigsten bis zum seltensten Fehler, aufgelistet, und es wird beschrieben, wie sie mithilfe von Protokollen analysiert und behandelt werden.

Teams kann nicht beendet werden

Wenn Teams feststellt, dass es auf eine neuere Version aktualisiert werden muss, wird die neue App heruntergeladen und bereitgestellt. Dann wird auf eine Möglichkeit zu einem Neustart gewartet, wenn der Computer im Leerlauf ist. Ein häufiges Problem während dieses Prozesses ist, wenn ein anderer Prozess oder ein Dateisystemtreiber den Teams.exe-Prozess sperrt und dadurch das Beenden von Teams.exe verhindert. Die Teams-App kann daher nicht durch die neu heruntergeladene und bereitgestellte App ersetzt werden.

Problembehebungstipps:

  • Um sich zu vergewissern, dass dieses Problem bei Ihnen auftritt, beenden Sie die Teams. (Klicken Sie dazu in der Taskleiste mit der rechten Maustaste auf Teams, und klicken Sie dann auf Beenden.) Öffnen Sie dann den Task-Manager in Windows, um zu überprüfen, ob noch eine Instanz von Teams ausgeführt wird.
  • Wenn Sie sich nicht an dem Computer befinden, auf dem das Problem auftritt, untersuchen Sie die %LocalAppData%\SquirrelTemp\SquirrelSetup.log, die von dem Computer, auf dem das Problem auftritt, gesammelt wurden, und suchen Sie im Protokoll nach einem Eintrag Programm: Der Prozess kann nicht beendet werden.
  • Um festzustellen, was das Beenden von Teams.exe verhindert, sehen Sie sich die Dlls.txt- und Handles.txt-Protokolle an, die Sie im Abschnitt Protokolle sammeln erstellt haben. Anhand dieser Protokolle können Sie die Prozesse ermitteln, die das Beenden von Teams verhindert haben.
  • Eine weitere Ursache, die das Beenden von Teams möglicherweise verhindert, ist der Kernelmodus-Dateisystemfilter-Treiber. Verwenden Sie das SysInternals-Tool ProcDump, um das Kernelmodus-Prozessabbild zu erfassen, indem Sie ausführen procdump -mk <pid>, wobei <pid> die Prozess-ID ist, die vom Task-Manager abgerufen wird. Sie können auch die Protokolldatei Driverquery.txt überprüfen, um die aktiven Filtertreiber anzuzeigen, die Teams möglicherweise beeinträchtigen.
  • Um dieses Problem zu beheben, starten Sie den Computer neu.

Dateiberechtigungen

Teams erstellt während des gesamten Installations- und Aktualisierungsprozesses eine Reihe von Unterordnern und Dateien im Profil des Benutzers. Da die App und der Updater als Benutzer ohne erhöhte Rechte ausgeführt werden, müssen Lese- und Schreibberechtigungen für die folgenden Ordner gewährt werden:

Ordner Verwendet von
%LocalAppData%\SquirrelTemp Teams-Installationsprogramm (z. B. Teams_Windows_x64.exe) während der Installationsphase
%LocalAppData%\Microsoft\Teams Team-Updater (Update.exe) zum Extrahieren und Bereitstellen des Anwendungspakets während des Updateprozesses
%AppData%\Microsoft\Teams Team-App (Teams.exe) zum Speichern von Einstellungen, App-Status und dem (vorinstallierten) heruntergeladenen Updatepaket

Wenn Teams der Zugriff verweigert wird, weil es nicht in eine Datei schreiben kann, wirkt sich eine andere Softwareanwendung möglicherweise störend aus, oder ein Sicherheitsbeschreibungseintrag schränkt den Schreibzugriff auf einen Ordner ein.

Problembehebungstipps:

  • Suchen Sie in %LocalAppData%\SquirrelTemp\SquirrelSetup.log oder %AppData%\Microsoft\Teams\logs.txt nach access denied-Beweisen Überprüfen Sie diese Dateien, um zu sehen, ob ein Versuch, in eine Datei zu schreiben, fehlgeschlagen ist.
  • Öffnen Sie Icacls.txt, und suchen Sie nach dem effektiven Zugriffssteuerungseintrag (ACE, Access Control Entry), der Schreiboperationen eines Benutzers, der kein Administrator ist, blockiert. Typischerweise befindet sich dieser in einem der DACL-Einträge. Weitere Informationen finden Sie in der Dokumentation zu icacls.

Beschädigte Datei

In einigen Fällen kann die Verschlüsselungssoftware Dateien im %LocalAppData%\Microsoft\Teams-Ordner ändern, was den Start von Teams verhindern kann. Dies kann jederzeit geschehen, auch wenn die App nicht aktualisiert wird. Wenn eine Datei beschädigt ist, besteht die einzige Möglichkeit, dieses Problem zu beheben, darin, Teams zu deinstallieren und neu zu installieren.

Hinweis

Wenn Sie die zugrundeliegende Ursache des Problems mit keinem dieser Schritte ermitteln können, können Sie es mit einer Prozessmonitor-Sitzung versuchen. Der Prozessmonitor ist ein Sysinternals-Tool, das den Zugriff auf die Registrierung und das Dateisystem aufzeichnet.