Windows에서 클래식 Microsoft Teams 설치 및 업데이트 문제 해결
이 자료에서는 Windows에서 실행 중인 Teams 데스크톱 클라이언트 앱의 설치 및 문제를 진단하고 해결하는 방법에 대한 지침을 제공합니다. 추가 문제 해결 정보는 Teams 문제 해결을 참조하세요.
[! 중요]
이 문서는 클래식 Microsoft Teams에만 적용됩니다. 새 Teams의 경우: 새 Teams 클라이언트의 설치 문제 해결을 참조하세요.
Teams가 제대로 업데이트되었는지 확인
다음 단계에 따라 Teams 업데이트가 설치되었는지 확인합니다.
- Teams에서 프로필 사진 옆에 있는 줄임표(...)를 선택한 다음 정보>버전을 클릭합니다. 현재 Teams 버전과 마지막 업데이트 시간을 보여주는 배너가 나타납니다. 예를 들어 Microsoft Teams 버전 1.5.00.3806(64비트)-E가 있습니다. 2022년 2월 16일에 마지막으로 업데이트되었습니다.
- 줄임표 메뉴를 다시 열고 업데이트 확인을 클릭합니다.
- 앱 상단에 있는 배너에 Teams의 "새로 고침"이 필요하다고 표시될 때까지 기다립니다. 이 프로세스는 새 버전의 Teams를 다운로드하므로 링크가 약 1분 후에 표시됩니다. 또한 최신 버전을 이미 실행 중인지 여부를 배너를 통해 알 수 있으며, 이 경우 업데이트할 필요가 없습니다.
- 배너에서 [새로 고침] 링크를 클릭합니다.
- 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파일은 Teams 앱을 서비스하는 실행 파일인Update.exe에 의해 작성됩니다.%AppData%\Microsoft\Teams\logs.txt파일은 Teams 앱(특히Teams.exe)에서 중요한 애플리케이션 이벤트를 기록하는 데 사용됩니다. 오류 정보는 포함 될 수 있습니다.
이러한 로그 파일에는 PII(개인 식별 정보)가 포함되어 있으므로 Microsoft로 전송되지 않습니다.
Teams는 정책에 따라 업데이트 프로세스를 자동으로 시작하거나 사용자가 프로필 사진 옆에 있는 줄임표(...) 메뉴로 이동하고 업데이트 확인을 선택하여 업데이트를 수동으로 확인할 수 있습니다. . 두 방법 모두 다음 이벤트 순서를 사용합니다.
- 업데이트 확인. Teams는 웹 요청을 하고 현재 앱 버전 및 배포 링 정보를 포함합니다. 이 단계의 목표는 다운로드 링크를 가져오는 것입니다. 이 단계의 오류는
%AppData%\Microsoft\Teams\logs.txt에 로그됩니다. - 업데이트를 다운로드합니다. Teams는 1단계에서 얻은 다운로드 링크를 사용하여 업데이트를 다운로드합니다. 다운로드가 완료되면 Teams는
Update.exe을(를) 호출하여 다운로드를 준비합니다. 다운로드 실패도%AppData%\Microsoft\Teams\logs.txt에 로그됩니다. - 업데이트를 준비합니다. 다운로드한 콘텐츠가 확인되고 중간 폴더
%LocalAppData%\Microsoft\Teams\stage에 압축이 풀립니다. 이 작업은Update.exe에서 수행됩니다. 이 단계의 실패는%LocalAppData%\Microsoft\Teams\SquirrelSetup.log에 로그됩니다. - 업데이트를 설치합니다. 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를 참조하세요.
로그 수집
Sysinternals 도구를 다운로드합니다.
로컬 드라이브의
%Temp%폴더에 zip 파일의 압축을 풉니다.관리자 권한 명령 프롬프트를 열고 다음을 수행합니다.
다음을 실행하여
%Temp%폴더로 이동합니다.cd /d %Temp%설정 및 응용 프로그램 로그를 복사합니다. 실패 지점에 따라 이러한 로그 중 일부가 없을 수도 있습니다.
copy %LocalAppData%\SquirrelTemp\SquirrelSetup.log SquirrelSetup.log copy %AppData%\Microsoft\Teams\logs.txt logs.txt copy %LocalAppData%\Microsoft\Teams\SquirrelSetup.log SquirrelSetup_Teams.log열린 핸들을 캡처하려면 다음을 실행합니다.
handle > handles.txt열린 DLL을 캡처하려면 다음을 실행합니다.
listdlls -v Teams > dlls.txt다음을 실행하여 실행 중인 드라이버를 캡처합니다.
driverquery /v > driverquery.txtTeams 폴더의 ACL(액세스 제어 목록)을 캡처하려면 다음을 실행합니다.
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> 는 작업 관리자에서 가져온 프로세스 ID입니다. 또한Driverquery.txt로그 파일을 검사하여 Teams를 방해할 수 있는 활성 필터 드라이버를 확인할 수 있습니다. - 이 상태에서 복구하려면 컴퓨터를 다시 시작합니다.
파일 사용 권한
Teams는 설치 및 업데이트 프로세스 동안 사용자의 프로필에 여러 개의 하위 폴더와 파일을 생성합니다. 앱과 업데이트 프로그램은 승격되지 않은 사용자로 실행되기 때문에 다음 폴더에 대한 읽기 및 쓰기 권한이 부여되어야 합니다.
| 폴더 | 사용자 |
|---|---|
%LocalAppData%\SquirrelTemp |
설치 단계 중 Teams 설치 프로그램(예: Teams_Windows_x64.exe) |
%LocalAppData%\Microsoft\Teams |
업데이트 프로세스 중에 앱 패키지를 추출하고 준비하는 Teams 업데이트 프로그램(Update.exe) |
%AppData%\Microsoft\Teams |
설정, 앱 상태 및 (사전 준비된) 다운로드한 업데이트 패키지를 저장하는 Teams 앱(Teams.exe) |
Teams에서 파일에 쓸 수 없어 액세스가 거부되는 경우 다른 소프트웨어 응용 프로그램이 간섭하거나 보안 설명자 항목이 폴더에 대한 쓰기 액세스를 제한할 수 있습니다.
문제 해결 팁:
%LocalAppData%\SquirrelTemp\SquirrelSetup.log또는%AppData%\Microsoft\Teams\logs.txt에서access denied증거를 찾으세요. 이 파일을 확인하여, 파일에 쓰려고 시도했으나 실패한 기록이 있는지 확인합니다.Icacls.txt을(를) 열고 관리자가 아닌 사용자의 쓰기 작업을 차단하는 효과적인 ACE(액세스 제어 항목)를 찾습니다. 일반적으로 DACL 항목 중 하나에 있습니다. 자세한 내용을 보려면 icacls 설명서를 참조하세요.
파일이 손상됨
경우에 따라 암호화 소프트웨어가 %LocalAppData%\Microsoft\Teams 폴더의 파일을 변경하여 Teams가 시작되지 않을 수 있습니다. 앱이 업데이트되지 않은 경우에도 언제든지 발생할 수 있습니다. 파일이 손상된 경우 이 상태에서 복구하는 유일한 방법은 Teams를 제거하고 다시 설치하는 것입니다.
참고
다음 단계 중 하나를 사용하여 문제의 근본 원인을 확인할 수 없는 경우 프로세스 모니터링 세션을 시도할 수 있습니다. 프로세스 모니터링은 레지스트리 및 파일 시스템에 대한 액세스를 기록하는 Sysinternals 도구입니다.
관련 항목
피드백
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요. https://aka.ms/ContentUserFeedback
다음에 대한 사용자 의견 제출 및 보기