다음을 통해 공유


새 Teams 클라이언트 설치 문제 해결

이 문서는 새 Microsoft Teams 클라이언트를 다운로드하고 설치하려고 할 때 발생하는 문제를 해결하는 데 도움이 됩니다.

설치 전 검사 스크립트를 실행하여 잠재적인 문제를 식별하고 제안된 해결 방법을 따릅니다.

정책 설정으로 인해 다운로드 및 설치가 금지됩니다.

사용자가 앱을 설치하려고 할 때 다음과 같은 오류 메시지가 표시되면 앱을 다운로드하고 설치하지 못하게 하는 제한 사항이 있음을 의미합니다.

조직 정책으로 인해 새 Teams를 설치할 수 없습니다. 자세한 내용은 IT 관리자에게 문의하세요.

조직 정책이 새 Teams의 설치를 제한하는 경우 오류 메시지의 스크린샷

그룹 정책 또는 타사 도구에 의해 설정된 레지스트리 키에 의해 MSIX 패키지 설치가 차단될 수 있습니다. 적용 가능한 레지스트리 키의 전체 목록은 그룹 정책이 패키지된 앱에서 작동하는 방식( MSIX)을 참조하세요.

다음 레지스트리 키는 새 Teams MSIX 패키지 설치를 차단할 수 있습니다.

  • BlockNonAdminUserInstall
  • AllowAllTrustedApps
  • AllowDevelopmentWithoutDevLicense

Important

사용하지 않도록 설정하면 AllowAllTrustedApps 새 Teams 앱(MSIX) 설치가 실패합니다. 이 문제는 Windows 10월 누적 업데이트 KB5031455 해결되었습니다.

이 선택적 10월 업데이트를 OS 빌드에 사용할 수 없는 경우 11월 보안 업데이트에 수정 사항이 포함됩니다.

이러한 세 개의 레지스트리 키는 다음 위치 중 하나에서 찾을 수 있습니다.

  • Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\AppModelUnlock
  • Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\Windows\Appx

일부 정책은 관리자가 설정한 제한적인 정책 때문에 이러한 레지스트리 키를 변경하고 조직에서 앱 설치를 차단할 수 있습니다. 설치를 방지할 수 있는 알려진 GPO 정책 중 일부는 다음과 같습니다.

  • 관리자가 아닌 사용자가 패키지된 Windows 앱을 설치하지 못하도록 방지
  • 신뢰할 수 있는 모든 앱 설치 허용(사용 안 함)

컴퓨터에 대한 제한 정책을 확인하는 방법

  1. Windows에서 그룹 정책 편집을 검색합니다. 또는 Windows 로고 단추를 마우스 오른쪽 단추로 클릭하고 실행을 선택한 다음 gpedit.msc를 입력합니다. 이 작업을 수행하면 로컬 그룹 정책 편집기가 열립니다.

  2. 컴퓨터 구성>관리 템플릿>Windows 구성 요소>앱 패키지 배포로 이동하고 다음 정책 설정을 확인합니다.

    • 관리자가 아닌 사용자가 패키지된 Windows 앱을 설치하지 못하도록 방지
    • Allow all trusted apps to install(모든 신뢰할 수 있는 앱을 설치할 수 있음)
  3. 이러한 설정이 구성되지 않음으로 설정되어 있는지 확인합니다.

참고 항목

조직의 컴퓨터에 새 Teams를 대량으로 배포하는 관리자는 새 Microsoft Teams 클라이언트로 대량 업그레이드를 참조하세요.

앱 전환기 토글 수정

  • 새 Teams 토글을 켜기 전에 현재 클라이언트를 다시 시작하여 최신 변경 내용이 있는지 확인합니다. 또한 보안 업데이트를 포함하여 보류 중인 Windows 업데이트가 있는 경우 새 Teams를 설치하기 전에 설치합니다.
  • 새 Teams 시도 토글이 표시되지 않으면 필요한 최소 버전의 Windows 및 Teams를 실행하고 있는지 확인합니다.
  • 새 Teams로 성공적으로 전환한 후 창의 왼쪽 위 모서리에서 토글을 찾아 새 Teams와 Microsoft Teams 클래식(회사 또는 학교) 간에 전환할 수 없는 경우 시작 메뉴 검색하거나 작업 표시줄에서 선택하여 원하는 버전을 시작합니다.

사용자가 앱 전환기 토글을 볼 수 없도록 차단할 수 있는 조건

다음 조건은 사용자가 앱 전환기 토글을 못하도록 차단할 수 있습니다.

  • 사용자의 관리자가 로그인 제한을 설정 했습니다.
  • 사용자가 Citrix 또는 VMware와 같은 VDI(가상 데스크톱 인프라) 컴퓨터에 있습니다.
  • 사용자는 Life용 Teams 계정 및 회사 계정으로 클래식 Teams에 로그인됩니다.
  • 사용자는 Life용 Teams 계정으로 클래식 Teams에 로그인됩니다 .

앱 전환기 토글을 차단하는 조건을 확인하는 방법

  1. 다음 경로 %appdata%/Microsoft/Teams에 있는 로그를 엽니다.

  2. logs.txt 엽니다.

  3. appswitcher_appstateservice_check 검색합니다.

  4. enggComplete 플래그를 확인합니다.

    • true이면 Microsoft에서 이 설정을 설정했습니다.
    • false이면 Microsoft에서 아직 설정을 켜지 않았거나 앱을 다시 시작해야 합니다.
  5. isAboveWin10Vibranium 플래그를 확인합니다.

    • true이면 OS 버전이 앱 전환기에서 필요한 버전보다 크거나 같습니다.
    • false이면 OS 버전이 Microsoft에서 지원하는 것보다 오래되었습니다.
  6. 다음 표의 코드를 확인하여 차단 조건의 원인을 알아봅니다.

    코드 의미
    TFLONLY Teams for Life에만 로그인했습니다.
    TFLANDTFW Teams for LifeTeams for Work에 로그인했습니다.
    SPECIALCLOUD 지원되지 않는 특수 클라우드에 로그인했습니다.
    CROSSCLOUD 정부 클라우드에 로그인했습니다.
    VDI VDI 컴퓨터(VMware, Citrix, AVD/WV)에 로그인했습니다.
    SIGNINRESTRICTED 지정된 테넌트에 로그인했지만 앱 전환기 토글이 표시되지 않습니다.

제목 표시줄에서 메시지 업데이트 및 다시 시작

사용자가 새 Teams를 옵트인한 후 제목 표시줄에서 업데이트 및 다시 시작 메시지를 받을 수 있습니다.

이 메시지는 예상되는 동작입니다. 링크를 선택하여 앱을 다시 시작합니다.

Windows 10 사용자가 오류 메시지를 받습니다.

Windows 10 사용자는 새 Teams를 다운로드하고 설치할 때 다음과 같은 오류 메시지를 받습니다.

문제가 발생했습니다.

이 문제를 해결하려면 WebView2 런타임을 다운로드하여 설치합니다. 그런 다음 Teams 데스크톱 앱을 다시 시작하고 다시 시도합니다.

어떤 사람들은 옵트인할 토글을 볼 수 없습니다.

사용자의 컴퓨터가 Teams 데스크톱 앱에 대한 최소 요구 사항을 충족하는지 확인합니다. 그런 다음 로그아웃한 후 Teams로 다시 로그인하도록 합니다.

토글이 여전히 표시되지 않는 경우 다음 단계를 수행합니다.

  1. 작업 표시줄에서 Teams 앱 아이콘을 마우스 오른쪽 단추로 클릭한 다음 종료를 선택합니다.
  2. 파일 탐색기를 엽니다. 주소 표시줄에서 다음 경로를 %appdata%/Microsoft/Teams입력한 다음 Enter 키를 누릅니다.
  3. 모든 폴더 내용을 삭제합니다(Teams 앱 및 사용자 지정 설정은 삭제되지 않음). 특정 파일이나 폴더를 삭제할 수 없다는 메시지가 표시되면 건너뛰기를 선택합니다.
  4. Teams 앱을 다시 시작하고 아이콘을 마우스 오른쪽 단추로 클릭한 다음 종료를 선택합니다.
  5. Teams 앱을 한 번 더 다시 시작합니다. 이제 토글 스위치가 표시됩니다.

그룹 정책을 사용하지 않도록 설정된 경우에도 다운로드 및 설치

신뢰할 수 있는 모든 앱이 그룹 정책을 사용 안 함으로 설정하여 설치하도록 허용하더라도 새 Teams 앱을 다운로드하고 설치수 있습니다.

  • Windows 10 또는 Windows 11 업데이트 버전 10D 이상을 실행하는 경우에도 새 Teams 앱을 다운로드하여 설치할 수 있습니다.
  • Windows 11 버전 21H1 SV1(빌드 10.0.22000)을 실행하는 경우 차단된 상태로 유지됩니다. 이 경우 새 Teams를 사용하려면 최신 버전의 Windows 11로 업그레이드해야 합니다.