Устранение неполадок с классической установкой и обновлением Microsoft Teams в Windows

  • Статья
  • Применяется к:
    Microsoft Teams

В этой статье приводятся рекомендации по диагностике и устранению неполадок при установке и обновлении клиентского приложения Teams, работающего в Windows. Дополнительные сведения об устранении неполадок см. в статье Устранение неполадок Teams.

[! Важно]

Эта статья относится только к классической версии Microsoft Teams. Сведения о новых командах см. в статье Устранение неполадок с установкой в новом клиенте Teams.

Проверьте, обновлен ли Teams успешно

Выполните следующие действия, чтобы проверить, успешно ли установлено обновление Teams.

  1. В Teams выберите многоточие (...) рядом со своим аватаром и щелкните О приложении>Версия. Появится баннер, демонстрирующий вашу текущую версию Teams и момент ее последнего обновления. Например: У вас установлено приложение Microsoft Teams версии 1.5.00.3806 (64-разрядная)-E. Последнее обновление: 16.02.2022.
  2. Снова откройте меню с многоточием и щелкните Проверить наличие обновлений.
  3. Подождите, пока баннер в верхней части приложения не укажет на необходимость "обновления" Teams. Ссылка должна появиться примерно через минуту, поскольку этот процесс загружает новую версию Teams. Баннер также дает вам знать, если вы уже используете последнюю версию, в этом случае обновление не требуется.
  4. Нажмите на ссылку обновления в баннере.
  5. Дождитесь перезапуска Teams, а затем повторите шаг 1, чтобы проверить, обновлено ли приложение.

Если вы видите сообщение об ошибке или номер версии такой же, как на шаге 4, процесс обновления завершился неудачно.

Устранение неполадок при установке и обновлении

Устранение проблем с установкой

Когда Teams установлен, установщик Teams регистрирует последовательность событий в %LocalAppData%\SquirrelTemp\SquirrelSetup.log. Первое, что нужно искать - это сообщение об ошибке или стек вызовов в конце журнала. Обратите внимание, что стеки вызовов в начале журнала могут не означать, что существует проблема установки. Может быть проще сравнить ваш журнал с журналом успешной установки (даже на другой машине), чтобы увидеть, что ожидается.

Если %LocalAppData%\SquirrelTemp\SquirrelSetup.log не указывает причину или вам нужна дополнительная информация для устранения проблемы, см. раздел Сбор и анализ журналов приложений и системы.

Устранение неполадок при обновлении

Когда Teams успешно установлен, расположение журнала изменяется с %LocalAppData%\SquirrelTemp на %LocalAppData%\Microsoft\Teams\SquirrelSetup.log. Еще один важный файл журнала: %AppData%\Microsoft\Teams\logs.txt.

  • Файл %LocalAppData%\Microsoft\Teams\SquirrelSetup.log записывается с помощью Update.exe, который является исполняемым файлом, обслуживающим приложение Teams.
  • Файл %AppData%\Microsoft\Teams\logs.txt используется приложением Teams (в частности, Teams.exe) для записи важных событий приложения. Скорее всего, он будет содержать информацию об ошибках.

Эти файлы журнала содержат персональные данные (PII), поэтому они не отправляются в Майкрософт.

Teams может автоматически запускать процесс обновления (в зависимости от политики), или пользователи могут вручную проверять наличие обновлений путем выбора меню с многоточием (...) рядом с аватаром и нажатия Проверить наличие обновлений. Оба метода используют следующую последовательность событий.

  1. Проверьте наличие обновлений. Teams делает веб-запрос и включают текущую версию приложения и информацию о кольце развертывания. Цель этого шага - получить ссылку для скачивания. Ошибка на этом этапе регистрируется в %AppData%\Microsoft\Teams\logs.txt.
  2. Скачивание обновления. Teams загружает обновление, используя ссылку для скачивания, полученную на шаге 1. Когда скачивание завершено, Teams вызывает Update.exe, чтобы предварительно подготовить скачивание. Ошибка скачивания также регистрируется в %AppData%\Microsoft\Teams\logs.txt.
  3. Подготовка обновления.. Скачанный контент проверяется и распаковывается в промежуточную папку %LocalAppData%\Microsoft\Teams\stage). Это выполняется посредством Update.exe. Сбои на этом этапе регистрируются в %LocalAppData%\Microsoft\Teams\SquirrelSetup.log.
  4. Установка обновления. Есть несколько способов запуска Teams. Система автоматически запускает Teams, когда пользователь входит в систему, или вы можете запускать Teams с помощью ярлыка. На этом этапе Update.exe проверяет наличие папки промежуточной подготовки, снова проверяет содержимое и выполняет операции с файлами, чтобы отменить промежуточную подготовку приложения. Для старой папки приложения в %LocalAppData%\Microsoft\Teams\current создается резервная копия в %LocalAppData%\Microsoft\Teams\previous, а папка промежуточной подготовки переименовывается в current. Сбои на этом этапе регистрируются в %LocalAppData%\Microsoft\Teams\SquirrelSetup.log.

Если %LocalAppData%\Microsoft\Teams\SquirrelSetup.log или %AppData%\Microsoft\Teams\logs.txt не содержат достаточной информации для определения основной причины и вам требуется дополнительная информация для устранения проблемы, перейдите к разделу Сбор и анализ журналов приложений и системы.

Собирать и анализировать журналы приложений и системы

В этом разделе описывается, как собирать и анализировать журналы приложений и системы, чтобы получить более полную информацию для устранения проблемы. Для выполнения этих шагов вы будете использовать инструменты Sysinternals. Чтобы узнать больше, см. Windows Sysinternals.

Соберите журналы.

  1. Загрузите инструменты Sysinternals.

  2. Распакуйте ZIP-файл в папку %Temp% на локальном диске.

  3. Откройте командную строку с повышенными правами и выполните следующие действия:

    1. Выполните следующее, чтобы перейти в папку %Temp%.

      cd /d %Temp%

    2. Скопируйте настройки и журналы приложений. Обратите внимание, что в зависимости от точки сбоя некоторые из этих журналов могут отсутствовать.

      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. Запустите следующее, чтобы захватить открытые ручки.

      handle > handles.txt

    4. Запустите следующее, чтобы захватить открытые библиотеки DLL.

      listdlls -v Teams > dlls.txt

    5. Запустите следующее, чтобы перехватить работающие драйверы.

      driverquery /v > driverquery.txt

    6. Выполните следующее, чтобы получить списки контроля доступа (ACL) папки Teams.

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

Анализировать логи (для опытных пользователей)

Неудачное обновление может привести к непредсказуемому поведению приложения. Например, пользователи могут быть не в состоянии выйти из Teams, иметь устаревшую версию Teams или не могут запустить Teams. Если у вас возникла проблема во время обновления, первое место для поиска причины — это %LocalAppData%\SquirrelTemp\SquirrelSetup.log. Ниже перечислены различные типы сбоев обновления, перечисленные от наиболее распространенных до наименее распространенных, и способы их анализа и устранения неполадок с использованием журналов.

Невозможно выйти из Teams

Поскольку Teams определяет, что им необходимо обновить себя до более новой версии, они загружают и запускают новое приложение, а затем ждут возможности перезагрузить себя в следующий раз, когда машина простаивает. Распространенной проблемой в этом процессе является случай, когда другой процесс или драйвер файловой системы блокирует процесс Teams.exe, что препятствует выходу Teams.exe. В результате приложение Teams не может быть заменено недавно загруженным и подготовленным приложением.

Советы по устранению неполадок

  • Чтобы подтвердить, что это проблема, с которой вы столкнулись, закройте Teams (щелкните правой кнопкой мыши Teams на панели задач и выберите Выйти). Затем откройте диспетчер задач в Windows, чтобы увидеть, работает ли экземпляр Teams.
  • Если вы не находитесь на компьютере, где возникла эта проблема, проверьте файл %LocalAppData%\SquirrelTemp\SquirrelSetup.log, полученный с компьютера, на котором возникла эта проблема, и найдите запись Программа: невозможно завершить процесс в журнале.
  • Чтобы определить, что препятствует выходу Teams.exe, просмотрите журналы Dlls.txt и Handles.txt, созданные в разделе Сбор журналов. Они рассказывают вам о процессах, которые препятствовали выходу Teams.
  • Другим виновником, который может помешать выходу Teams, является драйвер фильтра файловой системы режима ядра. Используйте средство SysInternals ProcDump для сбора дампа процесса в режиме ядра путем запуска procdump -mk <pid>, где <pid> — это идентификатор процесса, полученный из диспетчера задач. Вы также можете проверить файл журнала Driverquery.txt, чтобы увидеть активные драйверы фильтров, которые могут мешать Teams.
  • Чтобы выйти из этого состояния, перезагрузите компьютер.

Разрешения для файлов

Teams создает несколько подпапок и файлов в профиле пользователя на протяжении всего процесса установки и обновления. Так как приложение и средство обновления работают как пользователь без повышенных прав, разрешения на чтение и запись должны быть предоставлены в следующих папках.

Folder Используется
%LocalAppData%\SquirrelTemp Установщик Teams (например, Teams_Windows_x64.exe) на этапе установки
%LocalAppData%\Microsoft\Teams Средство обновления Teams (Update.exe) для извлечения и установки пакета приложения во время обновления
%AppData%\Microsoft\Teams Приложение Teams (Teams.exe) для сохранения настроек, состояний приложения и (предварительно подготовленного) скачанного пакета обновления

Если Teams отказало в доступе из-за невозможности записи в файл, это может помешать другому программному приложению или запись дескриптора безопасности может ограничить доступ для записи в папку.

Советы по устранению неполадок

  • Найдите свидетельство access denied в %LocalAppData%\SquirrelTemp\SquirrelSetup.log или %AppData%\Microsoft\Teams\logs.txt. Проверьте эти файлы, чтобы увидеть, была ли попытка записи в файл, который не удался.
  • Откройте Icacls.txt и найдите действующий элемент управления доступом (ACE), блокирующий операции записи пользователем, который не является администратором. Как правило, он находится в одной из записей DACL. Для получения дополнительной информации см. Документацию icacls.

Файл поврежден

В некоторых случаях программное обеспечение для шифрования может изменять файлы в папке %LocalAppData%\Microsoft\Teams, что может препятствовать запуску Teams. Это может произойти в любое время, даже если приложение не обновляется. Когда файл поврежден, единственный способ восстановления из этого состояния — удалить и переустановить Teams.

Примечание.

Если вы не можете определить основную причину проблемы с помощью любого из этих шагов, вы можете попробовать сеанс Монитор процесса. Process Monitor - это инструмент Sysinternals, который записывает доступ к реестру и файловой системе.