Add art. "Downgrade WebView2 Runtime to earlier version" - #3908
Add art. "Downgrade WebView2 Runtime to earlier version"#3908Michael Hoffman (mikehoffms) wants to merge 15 commits into
Conversation
Michael Hoffman (mikehoffms)
added
in-progress
cat: webview2
Michael Hoffman (mikehoffms)
changed the title
Michael Hoffman (mikehoffms)
changed the title
Michael Hoffman (mikehoffms)
changed the title
Michael Hoffman (mikehoffms)
changed the title
Michael Hoffman (mikehoffms)
changed the title
|
Learn Build status updates of commit 25e202a: ✅ Validation status: passed
For more details, please refer to the build report. |
PoliCheck Scan ReportThe following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 and severity-2 issues. The AI Review Details column lists suggestions for either removing or replacing the terms. If you find a false positive result, mention it in a PR comment and include this text: #policheck-false-positive. This feedback helps reduce false positives in future scans. ✅ No issues foundMore information about PoliCheckInformation: PoliCheck | Severity Guidance | Term |
|
Learn Build status updates of commit 9cd39d2: ✅ Validation status: passed
For more details, please refer to the build report. |
PoliCheck Scan ReportThe following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 and severity-2 issues. The AI Review Details column lists suggestions for either removing or replacing the terms. If you find a false positive result, mention it in a PR comment and include this text: #policheck-false-positive. This feedback helps reduce false positives in future scans. ✅ No issues foundMore information about PoliCheckInformation: PoliCheck | Severity Guidance | Term |
|
Learn Build status updates of commit ff08f90: ✅ Validation status: passed
For more details, please refer to the build report. |
PoliCheck Scan ReportThe following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 and severity-2 issues. The AI Review Details column lists suggestions for either removing or replacing the terms. If you find a false positive result, mention it in a PR comment and include this text: #policheck-false-positive. This feedback helps reduce false positives in future scans. ✅ No issues foundMore information about PoliCheckInformation: PoliCheck | Severity Guidance | Term |
|
Learn Build status updates of commit 67292e3: ✅ Validation status: passed
For more details, please refer to the build report. |
PoliCheck Scan ReportThe following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 and severity-2 issues. The AI Review Details column lists suggestions for either removing or replacing the terms. If you find a false positive result, mention it in a PR comment and include this text: #policheck-false-positive. This feedback helps reduce false positives in future scans. ✅ No issues foundMore information about PoliCheckInformation: PoliCheck | Severity Guidance | Term |
PoliCheck Scan ReportThe following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 and severity-2 issues. The AI Review Details column lists suggestions for either removing or replacing the terms. If you find a false positive result, mention it in a PR comment and include this text: #policheck-false-positive. This feedback helps reduce false positives in future scans. ✅ No issues foundMore information about PoliCheckInformation: PoliCheck | Severity Guidance | Term |
|
Learn Build status updates of commit 3e0a2e1: ✅ Validation status: passed
For more details, please refer to the build report. |
Michael Hoffman (mikehoffms)
changed the title
PoliCheck Scan ReportThe following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 and severity-2 issues. The AI Review Details column lists suggestions for either removing or replacing the terms. If you find a false positive result, mention it in a PR comment and include this text: #policheck-false-positive. This feedback helps reduce false positives in future scans. ✅ No issues foundMore information about PoliCheckInformation: PoliCheck | Severity Guidance | Term |
|
Learn Build status updates of commit 4c153aa: ✅ Validation status: passed
For more details, please refer to the build report. |
|
Learn Build status updates of commit 8169e69: 💡 Validation status: suggestions
microsoft-edge/webview2/concepts/enterprise.md
For more details, please refer to the build report. Note: Your PR may contain errors or warnings or suggestions unrelated to the files you changed. This happens when external dependencies like GitHub alias, Microsoft alias, cross repo links are updated. Please use these instructions to resolve them. |
PoliCheck Scan ReportThe following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 and severity-2 issues. The AI Review Details column lists suggestions for either removing or replacing the terms. If you find a false positive result, mention it in a PR comment and include this text: #policheck-false-positive. This feedback helps reduce false positives in future scans. ✅ No issues foundMore information about PoliCheckInformation: PoliCheck | Severity Guidance | Term |
|
|
||
| 1. In File Explorer, navigate to: `C:\Program Files (x86)\Microsoft\EdgeWebView\Application\` | ||
|
|
||
| 1. Confirm that a new folder appears, matching the downgraded version (such as `145.x.xxxx.xx`). |
There was a problem hiding this comment.
| 1. Confirm that a new folder appears, matching the downgraded version (such as `145.x.xxxx.xx`). | |
| 1. Confirm that a new folder appears, matching the downgraded version (such as `147.x.xxxx.xx`). |
| | Aspect | Value | | ||
| |---|---| | ||
| | **Area Path:** | Edge\Web Experience\WebView2\Distribution | | ||
| | **DL:** | [wv2addr@microsoft.com](mailto:wv2addr@microsoft.com)<!-- todo: scrub email --> | |
There was a problem hiding this comment.
scrub email addr
|
|
||
| 1. CSS troubleshoots the issue by using this article. | ||
|
|
||
| 1. If unresolved, CSS escalates the issue to the WebView2 Platform team ICM<!-- todo: expand ICM -->. |
There was a problem hiding this comment.
expand ICM
|
|
||
| If no exact matching folder is found, the policy has no effect, and the Runtime defaults to the `BrowserExecutableFolder` policy or the Evergreen Runtime (the default auto-updating Runtime). | ||
|
|
||
| * The updater<!-- todo: Edge Updater? --> will **automatically download** the required version if it satisfies the N-1 and/or N-2 conditions. The IT Admin doesn't need to pre-stage version folders on disk. |
There was a problem hiding this comment.
| * The updater<!-- todo: Edge Updater? --> will **automatically download** the required version if it satisfies the N-1 and/or N-2 conditions. The IT Admin doesn't need to pre-stage version folders on disk. | |
| * The Edge Updater will automatically download the required version if it satisfies the N-1 and/or N-2 conditions. The IT Admin doesn't need to pre-stage version folders on disk. |
|
|
||
| 1. The IT Admin sets policy by using Group Policy, specifying the `AppId` and `TargetVersion`. | ||
|
|
||
| 1. The Updater<!-- todo: Edge Updater? --> reads the policy, and validates that `TargetVersion` is within N-1 or N-2. |
There was a problem hiding this comment.
| 1. The Updater<!-- todo: Edge Updater? --> reads the policy, and validates that `TargetVersion` is within N-1 or N-2. | |
| 1. The Edge Updater reads the policy, and validates that `TargetVersion` is within N-1 or N-2. |
|
|
||
| 1. The Updater<!-- todo: Edge Updater? --> reads the policy, and validates that `TargetVersion` is within N-1 or N-2. | ||
|
|
||
| 1. Downloads<!-- todo: who is the actor? the WebView2 app? --> the downgraded version of the WebView2 Runtime, if needed, as a side-by-side install. |
There was a problem hiding this comment.
who is the actor in these steps? missing first word of each step: who? Maybe: the Edge Updater.
Rinku Stephen (@Rinku-Stephen) Shreya Shree (@shreyashree16)
| <!-- ====================================================================== --> | ||
| ## Temporarily downgrading the WebView2 Runtime | ||
|
|
||
|
|
There was a problem hiding this comment.
Michael Hoffman (@mikehoffms) / Rinku Stephen (@Rinku-Stephen)
steps for updating the policy template is also missing
Copy the Policy files from here - Download and Deploy Microsoft Edge for Business
Copy group policy files admx and adml here - C:\Windows\PolicyDefinitions
|
|
||
| 1. Enable the policy, and enter this information: | ||
|
|
||
| * **Name:** The application identifier (AUMID). Or, the `.exe` name, such as `teams.exe`. |
There was a problem hiding this comment.
please update the app names everywhere
correct names are : ms-teams.exe for microsoft teams
olk.exe for outlook
|
|
||
| ``` | ||
| Key: HKLM\Software\Policies\Microsoft\Edge\WebView2\DowngradeVersion | ||
| Value: teams.exe = "145" |
There was a problem hiding this comment.
please update the values
major versions are not supported anymore
exact version are supported
| * The Application User Model ID (AUMID), for packaged/MSIX apps. | ||
| * The executable name (such as `teams.exe`). | ||
|
|
||
| * If both an AUMID and `.exe` name entry exist for the same WebView2 app, the AUMID entry takes precedence. |
There was a problem hiding this comment.
Michael Hoffman (@mikehoffms) / Rinku Stephen (@Rinku-Stephen)
let's add steps for how to find exe name
- Open Task Manager → Details tab.
- Find the running application.
- Check the Name column, such as ms-teams.exe or olk.exe .
2 participants
Related PRs:
Rendered article for review:
Downgrade the WebView2 Runtime to an earlier version
/webview2/how-to/enterprise-downgrade.mdEnterprise management of WebView2 Runtimes > Downgrading the WebView Runtime to an earlier version
/webview2/concepts/enterprise.mdAB#63646255