새 버전의 WebView2 런타임이 특정 WebView2 앱에 중요한 회귀를 유발하는 경우 IT 관리는 임시 솔루션으로 정책을 사용하여 DowngradeVersion 해당 앱의 WebView2 런타임을 이전 버전으로 다운그레이드할 수 있습니다.
자세한 내용:
- 엔터프라이즈 다운그레이드 개요
- WebView2 런타임을 일시적으로 다운그레이드
- WebView2 런타임 다운그레이드의 제한 사항
- WebView2 런타임 다운그레이드의 위험
- 런타임 다운그레이드 테스트 및 문제 해결
- WebView2 런타임의 다운그레이드 제거
- WebView2 팀에 문의 에스컬레이션 및 연락
- 참고 항목
엔터프라이즈 다운그레이드 개요
기업에서 IT 관리는 정책을 사용하여 임시 조치로 WebView2 런타임을 이전 버전으로 다운그레이드할 수 있습니다.DowngradeVersion 에버그린 런타임을 사용할 때 새 런타임 버전에 심각한 회귀가 발생하면 WebView2 런타임을 사용하는 각 WebView2 앱과 각 Windows 구성 요소가 영향을 받을 수 있습니다. 엔터프라이즈 다운그레이드는 IT 관리가 영향을 받은 생산성을 복원하기 위한 단기 완화 접근 방식을 제공합니다.
이 DowngradeVersion 정책은 중요한 회귀로 인해 비즈니스 운영이 중단될 때 엔터프라이즈 IT 관리 특정 WebView2 애플리케이션(WebView2 앱)이 그룹 정책를 통해 이전 버전의 WebView2 런타임을 사용할 수 있도록 일시적으로 되돌리기할 수 있는 제어된 버전 다운그레이드 기능입니다.
Microsoft Edge WebView2 - 정책의 DowngradeVersion을 참조하세요.
에버그린 배포 모델은 WebView2 런타임이 Microsoft Edge와 함께 자동으로 업데이트되므로 WebView2 앱이 수동 개입 없이 항상 최신 버전의 WebView2 런타임에서 실행됨을 의미합니다. Evergreen WebView2 런타임은 WebView2 앱이 보안 패치 및 기능 개선을 자동으로 받을 수 있도록 합니다. 엔터프라이즈 IT 관리는 영향을 미치는 WebView2 런타임 업데이트를 제거할 수 없습니다.
WebView2는 Microsoft Teams , Outlook 및 타사 엔터프라이즈 소프트웨어와 같은 Windows 응용 프로그램이 Microsoft Edge 렌더링 엔진을 사용하여 웹 콘텐츠를 포함할 수 있도록 하는 브라우저 컨트롤입니다.
엔터프라이즈 다운그레이드 작동 방식
IT 관리는 새 WebView2 런타임 버전이 특정 WebView2 앱을 손상시켰음을 식별합니다.
IT 관리는 이 WebView2 앱에 대해 최신 WebView2 런타임 대신 특정 이전 버전의 WebView2 런타임을 사용하도록 지정하는 그룹 정책을 설정합니다.
현재 Evergreen WebView2 런타임 버전과 상대적인 WebView2 런타임 버전 N-1 또는 N-2만 지원됩니다. 버전 N-2 이전의 WebView2 런타임 버전으로 다운그레이드하는 것은 거부됩니다.
Edge 업데이트 프로그램은 이전 WebView2 런타임 버전을 현재 WebView2 런타임과 나란히 다운로드하여 설치합니다.
WebView2 로더는 대상 WebView2 앱만 이전 WebView2 런타임으로 리디렉션합니다.
장치의 다른 모든 WebView2 앱은 최신 WebView2 런타임 버전을 계속 사용합니다. 다운그레이드의 영향을 받지 않습니다.
고정된 버전이 더 이상 WebView2 런타임의 이전 두 가지 최신 버전에 있지 않으면 다운그레이드가 자동으로 만료됩니다.
엔터프라이즈 다운그레이드가 존재하는 이유
엔터프라이즈 다운그레이드는 최후의 수단인 복구 도구입니다. 엔터프라이즈 다운그레이드는 WebView2 앱 소유자와 협력하여 엔터프라이즈 IT 관리가 대상으로 지정하고 시간이 제한되며 관리합니다. 엔터프라이즈 다운그레이드는 버전 고정 메커니즘이 아닙니다.
엔터프라이즈 다운그레이드는 영향을 받는 특정 WebView2 앱에 대해 일시적이고 관리되는 버전 다운그레이드를 제공하는 한편, 플랫폼 팀이 적절한 수정 사항을 준비합니다. 엔터프라이즈 다운그레이드는 중요한 회귀로 인해 비즈니스 운영이 적극적으로 중단되고 핫픽스, 기능 플래그 또는 업데이트 일시 중지와 같은 다른 완화 조치가 문제를 적시에 resolve 수 없는 경우, 최후의 수단 복구 조치로만 사용해야 합니다. 다운그레이드는 플랫폼 팀이 적절한 수정 사항을 제공할 시간을 벌어줍니다. 다운그레이드는 적절한 수정 사항을 제공하는 것을 대신하지 않습니다.
미션 크리티컬 엔터프라이즈 환경에서는 WebView2 런타임의 예기치 않은 회귀로 인해 즉각적인 해결 방법 없이 비즈니스 워크플로가 중단될 수 있습니다. 짧은 중단이라도 수익 손실, SLA 누락, 운영 비용 증가로 이어집니다. 예를 들어 중요 업무용 엔터프라이즈 환경에는 다음이 포함됩니다.
- 의료 시스템
- 금융 거래 플랫폼
- 소매 POS(Point Of Sale)
- 정부 서비스
적용 가능한 WebView2 앱
WebView2 런타임의 엔터프라이즈 다운그레이드는 WebView2 앱에 자동으로 영향을 주지 않습니다. IT 관리는 특정 WebView2 앱에 대한 정책을 명시적으로 구성 DowngradeVersion 해야 합니다. 그러면 정책이 해당 특정 WebView2 앱에만 적용됩니다.
다음 유형의 WebView2 앱을 대상으로 할 수 있습니다.
엔터프라이즈 관리 Windows 장치에서 실행되는 모든 WebView2 Evergreen-Runtime 앱입니다.
IT 관리는 다음 중 하나를 통해 대상을 지정합니다.
- 패키지/MSIX 앱의 경우 AUMID(애플리케이션 사용자 모델 ID)입니다.
- 실행 파일 이름(예:
ms-teams.exe).
동일한 WebView2 앱에 대한 AUMID 및
.exe이름 항목이 모두 있는 경우 AUMID 항목이 우선합니다.
이름을 찾으려면 다음을 수행합니다..exe
작업 관리자를 연 다음 왼쪽에서 세부 정보를 선택합니다.
실행 중인 WebView2 앱을 찾습니다.
WebView2 앱의 이름 열(예
ms-teams.exe: 또는olk.exe)을 검사합니다.
다음 유형의 WebView2 앱은 정책의 영향을 받지 않습니다.DowngradeVersion
정책에
DowngradeVersion지정되지 않은 WebView2 앱.- 이러한 앱은 최신 WebView2 Evergreen 런타임을 계속 사용합니다.
소비자 장치 또는 관리되지 않는 장치의 WebView2 앱.
앱 번들(고정 버전) WebView2 런타임을 사용하는 WebView2 앱.
정책 구성 및 우선 순위
HKEY_CURRENT_USER(HKCU)는 지원되지 않습니다. 컴퓨터 수준 엔터프라이즈 정책 전용(HKEY_LOCAL_MACHINE(HKLM))입니다.
| 위치 | 경로 |
|---|---|
| 그룹 정책(권장) | 컴퓨터 구성>관리 템플릿>Microsoft Edge WebView2>응용 프로그램별 WebView2 다운그레이드 버전 구성 |
| 레지스트리 | HKLM\Software\Policies\Microsoft\Edge\WebView2\DowngradeVersion |
여러 정책이 존재하는 경우 우선 순위(최고에서 최저):
DowngradeVersion 정책 — 항상 성공합니다.
BrowserExecutableFolder — IT 관리가 독립적으로 설정한 경우.
기본 에버그린 런타임 — 최저.
와 BrowserExecutableFolder 둘 다 DowngradeVersion 독립적으로 구성된 DowngradeVersion 경우 우선적으로 리디렉션을 BrowserExecutableFolder 재정의합니다.
핵심 디자인 원칙
엔터프라이즈 IT 관리 주도: IT 관리자만 그룹 정책을 통해 다운그레이드를 시작할 수 있습니다. 개발자와 최종 사용자는 트리거할 수 없습니다.
업데이트 프로그램 서비스 규정 준수: Edge 업데이트 프로그램은 필요한 경우 필요한 버전을 다운로드하고 다른 모든 앱에 대해 일반 업데이트를 계속합니다.
자동 만료: 다운그레이드된 버전은 가장 최근의 두 이전 버전(N-1 또는 N-2) 내에 있는 경우에만 유효합니다. 다운그레이드된 버전 이상으로 두 개의 후속 주 버전이 릴리스되면 다운그레이드가 만료되고 앱이 자동으로 최신 런타임으로 되돌아갑니다. IT 관리자는 부실 정책이 자동 만료된 후 제거해야 합니다.
앱별 타겟팅: 다운그레이드는 장치 전체가 아닌 앱별로 적용됩니다. 각 WebView2 앱은 정책에서 개별적으로 지정해야 합니다.
WebView2 런타임을 일시적으로 다운그레이드
정책 템플릿 업데이트
정책 템플릿을 업데이트하려면 다음을 수행합니다.
비즈니스용 Microsoft Edge 다운로드 및 배포로 이동합니다.
최신 버전 다운로드 섹션에서 다음 단추 중 하나를 클릭합니다.
- Windows
- macOS
- Linux
다운로드를 클릭합니다 . 다음과 같은 정책 링크:
- Windows 64비트 정책 다운로드
- Windows 32비트 정책 다운로드
- Windows ARM64 정책 다운로드
- macOS 유니버설 정책 다운로드
- Linux(.rpm) 정책 다운로드
- Linux(.deb) 정책 다운로드
Microsoft Edge 정책 파일 다운로드 대화 상자가 열립니다.
수락 및 다운로드 버튼을 클릭합니다.
.와
MicrosoftEdgePolicyTemplates.cab같은 파일이 다운로드됩니다.Microsoft Edge에서 설정 등 (...)을 선택하고 다운로드를 선택한 다음 다운로드한 파일의 경우 포함된 폴더 열기를 클릭합니다.
Windows에서 파일이
MicrosoftEdgePolicyTemplates.cab선택된 상태로 파일 탐색기가 열립니다.마우스 오른쪽 단추를 클릭
MicrosoftEdgePolicyTemplates.cab한 다음 열기를 선택합니다.MicrosoftEdgePolicyTemplates.zip나타납니다.마우스 오른쪽 단추를 클릭
MicrosoftEdgePolicyTemplates.zip한 다음 추출을 선택합니다.대상 선택 대화 상자가 열립니다.
디렉터리(예
C:\Users\local-account\Downloads: )를 선택한 다음 추출 단추를 클릭합니다.다음과 같은 폴더가 만들어집니다.
C:\Users\local-account\Downloads\MicrosoftEdgePolicyTemplates.zip왼쪽에서 를 선택한
MicrosoftEdgePolicyTemplates.zip다음 오른쪽에서 디렉터리를/windows/엽니다.폴더
/adm/와/admx/나열됩니다.폴더
/adm/및/admx/디렉터리에 복사/PolicyDefinitions/합니다. 예를 들어 Windows의 경우 and/admx/폴더를/adm/에 복사합니다.C:\Windows\PolicyDefinitions\대상 폴더 액세스 거부 대화 상자가 열리고 "이 폴더에 복사하려면 관리자 권한을 제공해야 합니다"라는 메시지가 표시됩니다.
계속 버튼을 클릭합니다.
사용자 계정 컨트롤 대화 상자가 열립니다.
관리자 자격 증명을 입력합니다.
옵션 1: 그룹 정책(GPO)
엔터프라이즈 환경에 권장되는 방법입니다. 그룹 정책은 관리되는 장치 전반에 걸쳐 감사 가능한 중앙 집중식 관리를 보장합니다.
그룹 정책 편집기(
gpedit.msc)를 엽니다.이동 위치: 컴퓨터 구성 > 관리 템플릿 > Microsoft Edge WebView2
응용 프로그램별 WebView2 다운그레이드 버전 구성을 찾습니다.
정책을 사용하도록 설정하고 다음 정보를 입력합니다.
이름: 응용 프로그램 식별자(AUMID). 또는
.exe이름(예:ms-teams.exe).값: 대상 네 부분으로 된 버전 번호(예: 151.0.2178.0).
옵션 2: 레지스트리 편집기(regedit)
개별 컴퓨터의 대상 구성에 사용됩니다. 로컬 관리자 권한이 필요합니다.
관리자 권한으로 엽니다
regedit.이동 대상:
HKEY_LOCAL_MACHINE\Software\Policies\Microsoft\Edge\WebView2이름(없는 경우)이라는
DowngradeVersion새 키를 만듭니다.키 내에서
DowngradeVersion다음을 새로String Value (REG_SZ)만듭니다.값 이름: AUMID 또는 실행 파일 이름(예:
ms-teams.exe).값 데이터: 대상 주 버전 번호입니다.
네 부분으로 구성된 숫자 형식(예: 151.0.2178.0)을 사용하여 값을 대상 전체 버전 문자열로 설정합니다.
IT 관리는 안정 채널의 Microsoft Edge 릴리스 정보에서 정확한 네 부분으로 구성된 버전 번호를 찾을 수 있습니다.
예제 값:
- 이름:
ms-teams.exe, 값:151.0.2178.0 - 이름:
olk.exe, 값:152.0.2164.0
- 이름:
정책을 적용하려면 WebView2 앱을 다시 시작합니다.
예제:
Key: HKLM\Software\Policies\Microsoft\Edge\WebView2\DowngradeVersion
Value: ms-teams.exe = "151.0.2178.0"
Value: olk.exe = "152.0.2164.0"
중요 정보
(HKLM)만
HKEY_LOCAL_MACHINE지원됩니다.HKEY_CURRENT_USER(HKCU)는 무시됩니다.다음 값은 지원되지 않습니다.
- 주 전용 값(예: 151).
- 와일드카드 값(예: 151.*).
- 정확한 네 부분으로 구성된 숫자 버전이 아닌 값입니다.
WebView2 로더는 구성된 전체 버전과 정확히 일치하는 폴더가 있는 경우에만 런타임 설치 디렉터리를 확인합니다. 예를 들어 151.0.2178.0은 151.0.2178.0과 정확히 일치해야 합니다.
정확히 일치하는 폴더가 발견되지 않으면 정책이 적용되지 않으며 런타임은 기본적으로 정책 또는 에버그린 런타임(기본 자동 업데이트 런타임)으로 설정
BrowserExecutableFolder됩니다.Edge 업데이트 프로그램은 N-1 및/또는 N-2 조건을 충족하는 경우 필요한 버전을 자동으로 다운로드 합니다. IT 관리는 디스크에 버전 폴더를 미리 준비할 필요가 없습니다.
컴퓨터를 다시 시작할 필요는 없지만 WebView2 앱을 다시 시작해야 하며 다운그레이드가 적용되는 데 최대 1시간이 걸릴 수 있습니다.
WebView2 앱의 정책 대기 시간: 변경 내용은 배포 후 1시간 이내에 적용됩니다. 이는 Microsoft Edge 및 WebView2 업데이트 작업 케이던스와 일치합니다. 강제 업데이트를 트리거하려면 아래의 강제 업데이트 트리거를 참조하세요.
런타임 다운그레이드 정책 적용은 다음을 재정의합니다.
- 유지 관리 기간.
- 연장된 업데이트 간격.
- 마지막 검사 타임스탬프가 캐시되었습니다.
프로세스 흐름: 다운그레이드 구현 방법
IT 관리는 그룹 정책을 사용하여 정책을 설정하며, and
AppIdTargetVersion를 지정합니다.Edge 업데이트 프로그램은 정책을 읽고 N-1 또는 N-2 내에 있는지
TargetVersion확인합니다.Edge 업데이트 프로그램은 필요한 경우 다운그레이드된 버전의 WebView2 런타임을 병렬 설치로 다운로드합니다.
Edge 업데이트 프로그램은 대상 앱에 대한 정책을 설정
BrowserExecutableFolder하여 지정된 버전의 WebView2 런타임으로 리디렉션합니다.Edge 업데이트 프로그램은 WebView2 런타임의 다운그레이드 버전이 지원되는 범위 내에 있는 한 매핑을 유지합니다.
고정된 버전의 WebView2 런타임이 지원되는 범위를 벗어나거나 정책이 제거되면 Edge 업데이트 프로그램은 WebView2 앱을 정리하고 최신 버전의 WebView2 런타임을 사용하도록 되돌립니다.
WebView2 런타임 다운그레이드 정책이 활성화되어 있지만 대상 WebView2 런타임 버전이 아직 다운로드되지 않은 경우(예: 네트워크 또는 디스크 제약으로 인해) WebView2 앱은 이전 WebView2 런타임이 존재할 때까지 최신 WebView2 런타임을 계속 사용합니다. WebView2 런타임의 다운그레이드된 버전이 다운로드 대기 중이라는 이유만으로 WebView2 앱이 실행되지 않습니다 .
WebView2 런타임 다운그레이드의 제한 사항
버전 제한
| 제한 | 세부 사항 |
|---|---|
| 버전 범위 | 현재 Evergreen 런타임 버전에 상대적인 WebView2 런타임 버전 N-1 또는 N-2만 지원됩니다. 이전의 두 런타임 버전보다 이전의 WebView2 런타임으로 다운그레이드하는 것은 거부됩니다. |
| 버전 형식 | 주 버전 번호만 해당합니다(자릿수만). 전체 버전 문자열, 점 또는 와일드카드는 유효하지 않습니다. |
| 자동 만료 | WebView2 런타임의 다운그레이드 버전은 가장 최근의 두 개의 이전 버전 내에 있는 동안에만 활성 상태로 유지됩니다. 고정된 버전 이상의 두 가지 후속 런타임 릴리스 새 버전이 있으면 다운그레이드가 자동으로 만료되고 앱이 최신 WebView2 런타임으로 되돌아갑니다. |
| 사용 가능 | 다운그레이드 기능은 Microsoft Edge WebView2 버전 150 이상에서만 사용할 수 있습니다. |
범위 제한 사항
| 제한 | 세부 사항 |
|---|---|
| 엔터프라이즈 전용 | 소비자 또는 관리되지 않는 장치에서는 지원되지 않습니다. |
| 컴퓨터 수준만 | 정책은 로컬 컴퓨터(HKEY_LOCAL_MACHINE(HKLM)) 수준에서만 설정할 수 있습니다. 현재 사용자(HKEY_CURRENT_USER(HKCU))에 대한 다운그레이드 정책 설정은 지원되지 않습니다. 사용자 수준 정책이나 개별 사용자 수준 제어는 없습니다. |
| 앱별 타겟팅 | 모든 WebView2 앱에서 전사적 다운그레이드를 수행할 수 없습니다. 각 WebView2 앱은 개별적으로 대상으로 지정되어야 합니다. |
| 개발자 컨트롤 없음 | IT 관리만이 WebView2 런타임 다운그레이드를 시작할 수 있습니다. 개발자는 API를 통해 WebView2 런타임의 다운그레이드를 트리거할 수 없습니다. |
| 무기한 고정 없음 | 솔루션은 장기 또는 영구 버전 고정을 지원하지 않습니다. |
UDF(공유 사용자 데이터 폴더) 제약 조건
IT 관리는 동일한 WebView2 런타임 버전을 사용하도록 동일한 UDF(사용자 데이터 폴더)를 공유하는 모든 WebView2 앱을 다운그레이드해야 합니다.
WebView2 앱은 WebView2 UDF(사용자 데이터 폴더)를 공유하여 브라우저 상태를 다시 사용할 수 있습니다. UDF(사용자 데이터 폴더)를 공유하는 앱은 거의 없습니다. UDF를 공유하는 알려진 유일한 앱은 Office 제품군 앱인 Excel, Word 및 PowerPoint입니다.
다른 WebView2 런타임 버전에서 동일한 UDF에 액세스하는 것은 안전하지 않습니다. WebView2 앱 A가 다운그레이드되고 WebView2 앱 B가 동일한 UDF를 공유하지만 다운그레이드되지 않는 경우 WebView2 앱 A와 WebView2 앱 B는 모두 시작할 때 빠르게 실패합니다.
WebView2 런타임 다운그레이드의 위험
보안 위험
| 위험 | 설명 |
|---|---|
| 다시 도입된 취약성 | 다운그레이드하면 최신 버전에서 수정된 패치된 취약점이 다시 발생합니다. |
| 규정 준수 약화 | 이전 버전은 규제 환경에서 규정 준수를 위반할 수 있습니다. |
| 확장된 공격 노출 영역 | 여러 다운그레이드된 버전을 관리하면 오래된 클라이언트의 지속성이 향상됩니다. |
데이터 무결성 위험
| 위험 | 설명 |
|---|---|
| 저장소 손상 | 저장소 형식, 스키마 또는 API가 버전(쿠키, IndexedDB, 로컬 저장소)간에 변경된 경우 다운그레이드로 인해 손상되거나 호환되지 않을 수 있습니다. |
| 스키마 불일치 | 사용자 데이터 스냅샷을 사용하는 Edge 브라우저와 달리 WebView2는 플랫폼 수준 스냅샷을 구현하지 않습니다. |
| 사용자 데이터 손실 | 저장소 형식이 호환되지 않는 경우 프로필이 불안정해지고 데이터 손실이 발생할 수 있습니다. |
앱 호환성 위험
| 위험 | 설명 |
|---|---|
| 기능 종속성 중단 | 최신 WebView2 API 또는 동작을 사용하는 WebView2 앱은 WebView2 런타임을 다운그레이드한 후 실패하거나 예기치 않게 동작할 수 있습니다. |
| 성능 회귀 | 이전 버전의 WebView2 런타임은 페이지 로드 속도 저하, 메모리 사용량 증가, 환경 저하를 유발할 수 있습니다. |
| 앱 오작동 | WebView2 런타임을 다운그레이드하면 최근에 도입된 기능이나 렌더링 변경에 의존하여 WebView2 앱이 오작동할 수 있습니다. |
운영 위험
| 위험 | 설명 |
|---|---|
| 버전 조각화 | 앱 수준에서 다운그레이드를 지원하면 동일한 장치의 앱 간에 버전 이동이 발생할 수 있습니다. |
| 침전 | 시간이 지남에 따라 여러 이전 버전이 장치에 누적되어 복잡성이 증가합니다. |
| 디스크 사용량 증가 | 추가 WebView2 런타임 버전이 현재 Evergreen WebView2 런타임 버전과 나란히 설치되어 각 디바이스에서 추가 디스크 공간을 사용합니다. |
| 조정의 복잡성 | 다운그레이드하려면 IT 관리, WebView2 앱 소유자 및 플랫폼 팀 간의 신중한 조정이 필요합니다. |
런타임 다운그레이드 테스트 및 문제 해결
런타임 다운그레이드가 적용되었는지 확인
WebView2 런타임 다운그레이드 정책을 설정하고 대상 WebView2 앱을 다시 시작한 후 다음을 수행합니다.
1. 버전이 있는 폴더 확인
파일 탐색기에서 다음으로 이동합니다.
C:\Program Files (x86)\Microsoft\EdgeWebView\Application\다운그레이드된 버전(예:
150.0.2178.0)과 일치하는 새 폴더가 나타나는지 확인합니다.이 버전이 있는 폴더가 있으면 Edge 업데이트 프로그램이 다운그레이드된 WebView2 런타임을 가져오고 준비했음을 나타냅니다.
2. 레지스트리 정책 확인
다음에서 키가
DowngradeVersion설정되었는지 확인합니다.HKLM\Software\Policies\Microsoft\Edge\WebView2\DowngradeVersion항목이 구성된
AppId→TargetVersion와 일치하는지 확인합니다.
3. 리디렉션 확인 BrowserExecutableFolder
-
BrowserExecutableFolder앱이 다운그레이드된 런타임 경로를 가리키도록 정책을 자동으로 설정해야 합니다.
강제 업데이트 트리거
정책을 설정 DowngradeVersion 한 후 Edge 업데이트 프로그램은 대상 버전을 다운로드해야 합니다. 기본적으로 이 작업은 약 1시간 이내에 발생합니다(Edge/WebView2 업데이트 작업 케이던스에 맞춰).
즉시 업데이트를 트리거하려면 다음을 수행합니다.
관리자 권한으로 PowerShell을 엽니다.
Edge 업데이트 작업을 찾습니다.
Get-ScheduledTask -TaskPath "\Microsoft\EdgeUpdate\*" | Select TaskName, TaskPath작업을 실행합니다.
Start-ScheduledTask -TaskName "<task name from step 2>"다운로드가 완료될 때까지 몇 분 정도 기다립니다.
WebView2 앱을 다시 시작합니다.
심층적인 문제 해결을 위한 진단 도구
다음 도구는 문제 해결 을 위한 것이며 표준 확인에는 필요하지 않습니다.
| 도구 | 용도 |
|---|---|
| edge://webview2-internals | 활성 WebView2 프로세스, 사용 중인 런타임 버전을 봅니다. |
| ETW 추적 | 업데이트/다운그레이드 이벤트에 대한 하위 수준 진단 로그를 Capture합니다. |
| 이벤트 뷰어 | 응용 프로그램 로그에서 WebView2 업데이트 오류 또는 정책 적용 실패를 확인합니다. |
일반적인 문제 및 해결 방법
| 증상 | 가능한 원인 | 해결 방법 |
|---|---|---|
| 앱이 최신 버전에서 계속 실행 중임 | 앱이 다시 시작되지 않았습니다. | 컴퓨터가 아닌 WebView2 앱을 다시 시작합니다. |
| 다운그레이드된 폴더가 표시되지 않음 | 버전이 "N-1 또는 N-2" 범위를 벗어납니다. | 대상 버전이 가장 최근의 이전 두 버전 내에 있는지 확인합니다. |
| 앱을 시작할 때 빠르게 실패합니다(UDF(사용자 데이터 폴더)를 공유하는 모든 앱). | 공유 UDF 버전이 일치하지 않습니다. | 동일한 UDF를 사용하는 모든 앱을 동일한 버전으로 다운그레이드합니다. |
| 정책이 적용되지 않습니다. | 키 경로 또는 값 형식이 잘못되었습니다. | HKEY_LOCAL_MACHINE(HKLM) 경로, 값 이름 형식(AUMID 또는 .exe) 및 네 부분으로 된 숫자 형식(예: 151.0.2178.0)을 확인합니다. |
| 여러 앱이 예기치 않게 영향을 받습니다. | 공유 사용자 데이터 폴더 | UDF(사용자 데이터 폴더) 공유를 식별하고 영향을 받는 모든 앱이 정렬되었는지 확인합니다. |
| 다운그레이드가 예기치 않게 자동 되돌려졌습니다. | 고정된 버전이 지원되는 범위를 벗어났습니다. | 런타임 버전이 더 이상 버전 N-1 또는 N-2(이전 두 버전의 런타임) 내에 있지 않은 후에 WebView2 런타임의 다운그레이드가 만료되는 것이 예상됩니다. |
WebView2 런타임의 다운그레이드 제거
옵션 1: 그룹 정책 사용 안 함(권장)
중요: 레지스트리 키를 직접 삭제하지 마십시오. 항상 GPO(그룹 정책)를 사용하여 정책을 사용하지 않도록 설정하여 클린 제거를 보장하고 분리된 구성을 방지합니다.
GPO를 사용하여 다운그레이드를 구성한 경우:
그룹 정책 편집기(
gpedit.msc)를 엽니다.이동 위치: 컴퓨터 구성 > 관리 템플릿 > Microsoft Edge WebView2
"애플리케이션별 WebView2 다운그레이드 버전 구성"을 사용 안 함 또는 구성하지 않음으로 설정합니다.
WebView2 앱을 다시 시작합니다.
앱은 다음 실행 시 최신 에버그린 런타임으로 되돌리기 합니다.
옵션 2: 레지스트리를 통해 정책 제거
주의: 직접 레지스트리 조작은 원래 정책이 레지스트리 편집기를 통해 설정된 경우에만 사용해야 합니다. GPO(그룹 정책)를 사용한 경우에는 일관성을 보장하기 위해 항상 GPO를 사용하여 되돌리기 합니다.
정책이 원래 레지스트리를 통해 직접 설정된 경우(프로덕션에서는 권장되지 않음):
관리자 권한으로 엽니다
regedit.이동 대상:
HKEY_LOCAL_MACHINE\Software\Policies\Microsoft\Edge\WebView2\DowngradeVersion특정 값(예:
ms-teams.exe포함)을 삭제합니다.WebView2 앱을 다시 시작합니다.
옵션 3: 자동 만료
고정된 버전이 더 이상 가장 최근의 이전 두 버전에 포함되지 않으면 다운그레이드가 자동으로 만료됩니다.
트리거: 고정된 버전 이후로 두 개의 새로운 에버그린 버전이 릴리스되었습니다.
행동: Edge 업데이트 프로그램은 해당 앱을 최신 런타임으로 자동으로 되돌립니다.
관리 작업 필요: 부실 정책이 자동 만료되면 제거합니다.
예: 147이 최신 상태일 때 버전 145로 다운그레이드한 다음(145는 N-2) 버전 148이 릴리스된 경우 버전 145는 이제 다운그레이드 자동 만료→ 3개 뒤처져 있습니다.
되돌리기 후 동작
| 작업 | 발생하는 동작 |
|---|---|
| 애플리케이션 다시 시작 | WebView2 앱은 다음에 앱을 시작할 때 최신 WebView2 런타임을 선택합니다. |
| BrowserExecutableFolder | 자동으로 제거됨; WebView2 앱은 기본 WebView2 런타임 경로를 사용하도록 돌아갑니다. |
| 다운그레이드된 런타임 비트 | 예약된 케이던스에서 Edge 업데이트 프로그램으로 정리됩니다. |
| 사용자 데이터 | 제자리에 남아 있습니다. 자동 데이터 마이그레이션이 발생하지 않습니다. |
WebView2 팀에 문의 에스컬레이션 및 연락
에스컬레이션 경로:
엔터프라이즈 관리 담당자가 Microsoft CSS에 문의합니다.
CSS는 이 문서를 사용하여 문제를 해결합니다.
해결되지 않으면 CSS는 WebView2 플랫폼 팀 ICM으로 문제를 에스컬레이션합니다.
영역 경로:
Edge\Web Experience\WebView2\Distribution소유 서비스: Edge 브라우저 고객 인시던트.
소유 팀: Edge WebView2.
참고 항목:
참고 항목
- DowngradeVersionin Microsoft Edge WebView2 - 정책.
- 안정 채널에 대한 Microsoft Edge 릴리스 정보
외부: