Downgraden der WebView2-Runtime auf eine frühere Version

Wenn eine neue Version der WebView2-Runtime eine kritische Regression in einer bestimmten WebView2-App einführt, kann ein IT-Admin die WebView2-Runtime für diese App auf eine frühere Version herabstufen, indem er die DowngradeVersion Richtlinie als vorübergehende Lösung verwendet.

Detaillierter Inhalt:

Überblick über das Enterprise-Downgrade

In einem Unternehmen kann der IT-Admin die WebView2-Runtime mithilfe der DowngradeVersion Richtlinie vorübergehend auf eine frühere Version herabstufen. Wenn Sie bei Verwendung der Evergreen-Runtime eine kritische Regression in eine neue Runtime-Version einführen, sind wahrscheinlich jede WebView2-App und jede Windows-Komponente, die die WebView2-Runtime verwendet, betroffen. Ein Enterprise-Downgrade bietet einen kurzfristigen Ansatz zur Risikominderung für den IT-Admin, um die betroffene Produktivität wiederherzustellen.

Bei der DowngradeVersion Richtlinie handelt es sich um eine kontrollierte Versionsherabstufungfunktion, die es einem IT-Admin eines Unternehmens ermöglicht, eine bestimmte WebView2-Anwendung (WebView2-App) vorübergehend über eine Gruppenrichtlinie auf die Verwendung einer früheren Version der WebView2-Runtime rückgängig zu machen, wenn eine kritische Regression den Geschäftsbetrieb stört. Siehe DowngradeVersion in Microsoft Edge WebView2 – Richtlinien.

Das Evergreen-Verteilungsmodell bedeutet, dass die WebView2-Runtime automatisch zusammen mit Microsoft Edge aktualisiert wird, sodass die WebView2-App immer auf der neuesten Version der WebView2-Runtime ausgeführt werden muss, ohne dass ein manueller Eingriff erforderlich ist. Die Evergreen WebView2 Runtime stellt sicher, dass die WebView2-App automatisch Sicherheitspatches und Funktionsverbesserungen erhält. Der IT-Admin des Unternehmens kann das betroffene WebView2-Runtime-Update nicht deinstallieren.

WebView2 ist ein Browsersteuerelement, mit dem Windows-Anwendungen (z. B. Microsoft Teams, Outlook und Unternehmenssoftware von Drittanbietern) Webinhalte mithilfe des Microsoft Edge-Renderingmoduls einbetten können.

Funktionsweise eines Enterprise-Downgrades

  1. Der IT-Admin erkennt, dass eine neue WebView2-Runtimeversion eine bestimmte WebView2-App beschädigt hat.

  2. Der IT-Admin legt eine Gruppenrichtlinie fest, die angibt, dass für diese WebView2-App eine bestimmte vorherige Version der WebView2-Runtime anstelle der neuesten WebView2-Runtime verwendet werden soll.

    Es wird nur die WebView2-Runtime-Version N-1 oder N-2 relativ zur aktuellen Evergreen WebView2-Runtime-Version unterstützt. Ein Downgrade auf eine Version der WebView2-Runtime, die älter als Version N-2 ist, wird abgelehnt.

  3. Der Microsoft Edge Updater lädt die ältere WebView2-Runtimeversion parallel zur aktuellen WebView2-Runtime herunter und installiert sie.

  4. Das WebView2-Ladeprogramm leitet nur die WebView2-Ziel-App zur älteren WebView2-Runtime um.

  5. Alle anderen WebView2-Apps auf dem Gerät verwenden weiterhin die neueste WebView2-Runtime-Version. Sie sind von der Herabstufung nicht betroffen.

  6. Das Downgrade läuft automatisch ab, wenn sich die angeheftete Version nicht mehr innerhalb der beiden letzten vorherigen Versionen der WebView2-Runtime befindet.

Warum es ein Enterprise-Downgrade gibt

Ein Enterprise-Downgrade ist ein Wiederherstellungstool als letztes Mittel. Ein Enterprise-Downgrade wird zielgerichtet, zeitgebunden und vom IT-Admin des Unternehmens in Zusammenarbeit mit WebView2-App-Besitzern verwaltet. Ein Enterprise-Downgrade ist kein Versions-Pinning-Mechanismus.

Das Enterprise-Downgrade bietet ein temporäres, vom Admin gesteuertes Versions-Downgrade für die spezifische betroffene WebView2-App, während das Plattformteam einen entsprechenden Fix vorbereitet. Ein Enterprise-Downgrade sollte nur als letztes Mittel zur Wiederherstellung verwendet werden, wenn eine kritische Regression den Geschäftsbetrieb aktiv stört und keine andere Abhilfemaßnahme (z. B. ein Hotfix, ein Featureflag oder eine Updatepause) das Problem zeitnah beheben kann. Das Downgrade verschafft dem Plattformteam Zeit, um eine ordnungsgemäße Lösung zu liefern. Das Downgrade ist kein Ersatz für die Auslieferung einer richtigen Lösung.

In unternehmenskritischen Umgebungen können unerwartete Regressionen in der WebView2-Runtime Geschäftsabläufe ohne sofortige Abhilfe stoppen. Selbst kurze Ausfälle führen zu Umsatzeinbußen, verpassten SLAs und erhöhten Betriebskosten. Zu unternehmenskritischen Umgebungen zählen beispielsweise:

  • Gesundheitssysteme
  • Handelsplattformen für Finanzen
  • Verkaufsstelle für den Einzelhandel
  • Staatliche Dienstleistungen

Anwendbare WebView2-Apps

Ein Enterprise-Downgrade der WebView2-Runtime wirkt sich nicht automatisch auf eine WebView2-App aus. Der IT-Admin muss die DowngradeVersion Richtlinie für eine bestimmte WebView2-App explizit konfigurieren. Die Richtlinie gilt dann nur für diese spezifische WebView2-App.

Die folgenden Typen von WebView2-Apps können als Ziel verwendet werden:

  • Alle WebView2-Evergreen-Runtime-Apps, die auf vom Unternehmen verwalteten Windows-Geräten ausgeführt werden.

    • Der IT-Admin gibt das Ziel an, indem er entweder:

      • Die AUMID (Application User Model ID, Anwendungsbenutzermodell-ID) für gepackte/MSIX-Apps.
      • Der Name der ausführbaren Datei (z. B ms-teams.exe. ).

    • Wenn sowohl ein AUMID .exe - als auch ein Namenseintrag für dieselbe WebView2-App vorhanden sind, hat der AUMID-Eintrag Vorrang.

So finden Sie den .exe Namen:

  1. Öffnen Sie den Task-Manager, und wählen Sie dann auf der linken Seite "Details" aus.

  2. Suchen Sie die ausgeführte WebView2-App.

  3. Überprüfen Sie die Spalte Name für die WebView2-App, z. B ms-teams.exe . oder olk.exe.

Die folgenden Arten von WebView2-Apps sind von der DowngradeVersion Richtlinie nicht betroffen:

  • WebView2-Apps, die nicht in der DowngradeVersion Richtlinie angegeben sind.

    • Für solche Apps wird weiterhin die neueste WebView2 Evergreen-Runtime verwendet.

  • WebView2-Apps auf Verbrauchergeräten oder nicht verwalteten Geräten.

  • WebView2-Apps, die eine WebView2-Runtime im App-Bundle (Fixierte Version) verwenden.

Richtlinienkonfiguration und Rangfolge

HKEY_CURRENT_USER (HKCU) wird nicht unterstützt. Hierbei handelt es sich nur um eine Unternehmensrichtlinie auf Computerebene (HKEY_LOCAL_MACHINE (HKLM)).

Pfad Pfad
Gruppenrichtlinie (empfohlen) Computerkonfiguration>Administrative Vorlagen>Microsoft Edge WebView2>Konfigurieren einer Downgrade-Version von WebView2 pro Anwendung
Registrierung HKLM\Software\Policies\Microsoft\Edge\WebView2\DowngradeVersion

Rangfolge bei mehreren Richtlinien (höchste bis niedrigste):

  1. DowngradeVersion-Richtlinie — gewinnt immer.

  2. BrowserExecutableFolder – wenn unabhängig vom IT-Admin festgelegt.

  3. Default Evergreen Runtime — niedrigste.

Wenn beide DowngradeVersion und BrowserExecutableFolder unabhängig konfiguriert sind, DowngradeVersion hat dies Vorrang und überschreibt die BrowserExecutableFolder Umleitung.

Zentrale Designprinzipien

  • Gesteuert von IT-Admins in Unternehmen: Nur IT-Administratoren können ein Downgrade über eine Gruppenrichtlinie initiieren. Entwickler und Endbenutzer können es nicht auslösen.

  • Updater Service Compliance: Der Microsoft Edge Updater lädt bei Bedarf die erforderliche Version herunter und setzt die normalen Updates für alle anderen Apps fort.

  • Automatischer Ablauf: Eine herabgestufte Version bleibt nur so lange gültig, wie sie innerhalb der beiden letzten vorherigen Versionen (N-1 oder N-2) liegt. Sobald zwei aufeinanderfolgende neue Hauptversionen über die herabgestufte Version hinaus freigegeben werden, läuft das Downgrade ab und die App wird automatisch auf die neueste Runtime zurückgesetzt. Microsoft empfiehlt, dass der IT-Admin die veraltete Richtlinie entfernt, nachdem sie automatisch abgelaufen ist.

  • Zielgruppen-Targeting pro App: Downgrade wird pro App und nicht geräteweit angewendet. Jede WebView2-App muss in der Richtlinie einzeln angegeben werden.

Vorübergehendes Downgrade der WebView2-Runtime

Aktualisieren der Richtlinienvorlage

So aktualisieren Sie die Richtlinienvorlage:

  1. Navigieren Sie zu Herunterladen und Bereitstellen von Microsoft Edge for Business.

  2. Klicken Sie im Abschnitt "Neueste herunterladen " auf eine der folgenden Schaltflächen:

    • Windows
    • macOS
    • Linux

  3. Klicken Sie auf einen Download ... Richtlinienlink , z. B.:

    • Windows 64-Bit-Richtlinie herunterladen
    • Windows 32-Bit-Richtlinie herunterladen
    • Windows ARM64-Richtlinie herunterladen
    • Herunterladen der universellen macOS-Richtlinie
    • Herunterladen der Richtlinie für Linux (.rpm)
    • Richtlinie für Linux herunterladen (.deb)

    Das Dialogfeld "Microsoft Edge-Richtliniendatei herunterladen " wird geöffnet.

  4. Klicken Sie auf die Schaltfläche "Annehmen und herunterladen ".

    Eine Datei wird heruntergeladen, z. B MicrosoftEdgePolicyTemplates.cab. . .

  5. Wählen Sie in Microsoft Edge Einstellungen und mehr (...) aus, wählen Sie Downloads aus, und klicken Sie dann für die heruntergeladene Datei auf Enthaltenden Ordner öffnen.

    Unter Windows wird der Explorer geöffnet, in dem die Datei MicrosoftEdgePolicyTemplates.cab ausgewählt ist.

  6. Klicken Sie mit der rechten Maustaste auf MicrosoftEdgePolicyTemplates.cab, und wählen Sie dann Öffnen aus.

    MicrosoftEdgePolicyTemplates.zip angezeigt wird.

  7. Klicken Sie mit der rechten Maustaste auf MicrosoftEdgePolicyTemplates.zip, und wählen Sie dann "Extrahieren" aus.

    Das Dialogfeld "Ziel auswählen " wird geöffnet.

  8. Wählen Sie das Verzeichnis aus, z. B C:\Users\local-account\Downloads. , und klicken Sie dann auf die Schaltfläche Extrahieren .

    Ein Ordner wird erstellt, z. B.: C:\Users\local-account\Downloads\MicrosoftEdgePolicyTemplates.zip

  9. Wählen Sie auf der linken Seite die Option MicrosoftEdgePolicyTemplates.zipaus, und öffnen Sie dann auf der rechten Seite das /windows/ Verzeichnis.

    The folders /adm/ and /admx/ are listed.

  10. Kopieren Sie die Ordner /adm/ in /admx/ ein /PolicyDefinitions/ Verzeichnis. Kopieren Sie beispielsweise unter Windows die /adm/ Ordner "und /admx/ " nach C:\Windows\PolicyDefinitions\.

    Das Dialogfeld "Zugriff auf den Zielordner verweigert " wird mit der Meldung "Sie müssen zum Kopieren in diesen Ordner Administratorberechtigungen bereitstellen" geöffnet.

  11. Klicken Sie auf die Schaltfläche Weiter .

    Das Dialogfeld "Benutzerkontensteuerung " wird geöffnet.

  12. Geben Sie Administratoranmeldeinformationen ein.

Option 1: Gruppenrichtlinie (GPO)

Dies ist der empfohlene Ansatz für Unternehmensumgebungen. Gruppenrichtlinien sorgen für eine zentrale, überprüfbare Verwaltung über verwaltete Geräte hinweg.

  1. Öffnen Sie den Gruppenrichtlinien-Editor (gpedit.msc).

  2. Navigieren Sie zu: Administrative Vorlagen > für die Computerkonfiguration > Microsoft Edge WebView2

  3. Suchen Sie Konfigurieren der anwendungsbezogenen WebView2-Downgradeversion.

  4. Aktivieren Sie die Richtlinie, und geben Sie die folgenden Informationen ein:

    • Bezeichnung: Die Anwendungskennung (Application Identifier, AUMID). Oder der .exe Name, z. B ms-teams.exe.

    • Wert: Die vierteilige Zielversionsnummer (z. B. 151.0.2178.0).

Option 2: Registrierungs-Editor (regedit)

Für die gezielte Konfiguration auf einzelnen Maschinen. Erfordert lokale Administratorrechte.

  1. Als Administrator öffnen regedit .

  2. Navigieren Sie zu: HKEY_LOCAL_MACHINE\Software\Policies\Microsoft\Edge\WebView2

  3. Erstellen Sie einen neuen Schlüssel mit dem Namen DowngradeVersion (wenn er nicht vorhanden ist).

  4. Erstellen DowngradeVersion Sie im Schlüssel ein neues String Value (REG_SZ):

    • Wertname: Die AUMID oder der Name der ausführbaren Datei (z. B ms-teams.exe. ).

    • Wert: Die angestrebte Hauptversionsnummer.

      • Legen Sie den Wert auf die Zeichenfolge der vollständigen Zielversion im vierteiligen numerischen Format fest (z. B. 151.0.2178.0).

      • Der IT-Admin kann die genaue vierteilige Versionsnummer in den Microsoft Edge-Versionshinweisen für Stable Channel finden.

      • Beispielwerte:

        • Name: ms-teams.exe, Wert: 151.0.2178.0
        • Name: olk.exe, Wert: 152.0.2164.0

  5. Starten Sie die WebView2-App neu, damit die Richtlinie wirksam wird.

Beispiel:

Key:   HKLM\Software\Policies\Microsoft\Edge\WebView2\DowngradeVersion
Value: ms-teams.exe = "151.0.2178.0"
Value: olk.exe = "152.0.2164.0"

Wichtige Hinweise

  • Es wird nur HKEY_LOCAL_MACHINE (HKLM) unterstützt, HKEY_CURRENT_USER (HKCU) wird ignoriert.

  • Die folgenden Werte werden nicht unterstützt:

    • Reine Hauptwerte (z. B. 151).
    • Platzhalterwerte (z. B. 151.*).
    • Werte, bei denen es sich nicht um exakte vierteilige numerische Versionen handelt.

  • Das WebView2-Ladeprogramm löst das Runtime-Installationsverzeichnis nur auf, wenn ein Ordner vorhanden ist, der genau mit der konfigurierten Vollversion übereinstimmt. Beispielsweise muss 151.0.2178.0 genau mit 151.0.2178.0 übereinstimmen.

    Wenn kein exakt übereinstimmender Ordner gefunden wird, hat die Richtlinie keine Auswirkungen, und die Runtime wird standardmäßig auf die BrowserExecutableFolder Richtlinie oder die Evergreen-Runtime (die standardmäßige Runtime für automatische Aktualisierungen) festgelegt.

  • Der Microsoft Edge Updater lädt automatisch die erforderliche Version herunter, wenn sie die Bedingungen N-1 und/oder N-2 erfüllt. Der IT-Admin muss Versionsordner nicht vorab auf dem Datenträger bereitstellen.

  • Es ist kein Neustart des Computers erforderlich, aber die WebView2-App muss neu gestartet werden, und es kann bis zu 1 Stunde dauern, bis das Downgrade wirksam wird.

  • Richtlinienlatenz für die WebView2-App: Änderungen werden innerhalb von 1 Stunde nach der Bereitstellung wirksam. Dies ist auf den Rhythmus der Microsoft Edge- und WebView2-Updateaufgaben abgestimmt. Informationen zum Auslösen einer Force-Aktualisierung finden Sie weiter unten unter Auslösen einer Force-Aktualisierung.

  • Die Erzwingung der Downgrade-Richtlinie zur Laufzeit setzt Folgendes außer Kraft:

    • Wartungsfenster.
    • Erweiterte Updateintervalle.
    • Zwischengespeicherte Zeitstempel der letzten Überprüfung.

Prozessablauf: Wie Downgrade umgesetzt wird

  1. Der IT-Admin legt die Richtlinie mithilfe der Gruppenrichtlinie fest, wobei er die und TargetVersionangibtAppId.

  2. Der Microsoft Edge Updater liest die Richtlinie und überprüft, ob sie TargetVersion sich innerhalb von N-1 oder N-2 befindet.

  3. Der Microsoft Edge Updater lädt die herabgestufte Version der WebView2-Runtime bei Bedarf als parallele Installation herunter.

  4. Der Microsoft Edge Updater legt die Richtlinie für die Ziel-App fest BrowserExecutableFolder , um sie auf die angegebene Version der WebView2-Runtime umzuleiten.

  5. Der Microsoft Edge Updater behält die Zuordnung so lange bei, wie die herabgestufte Version der WebView2-Runtime im unterstützten Bereich bleibt.

  6. Wenn die angeheftete Version der WebView2-Runtime außerhalb des unterstützten Bereichs liegt oder die Richtlinie entfernt wird, bereinigt der Microsoft Edge Updater die WebView2-App und setzt sie auf die neueste Version der WebView2-Runtime zurück.

Wenn eine WebView2-Runtime-Downgrade-Richtlinie aktiv ist, die Ziel-WebView2-Runtime-Version jedoch noch nicht heruntergeladen wurde (z. B. aufgrund von Netzwerk- oder Festplatteneinschränkungen), verwendet die WebView2-App weiterhin die neueste WebView2-Runtime, bis die frühere WebView2-Runtime vorhanden ist. Der Start der WebView2-App ist nur deshalb nicht möglich, weil der Download der heruntergestuften Version der WebView2-Runtime aussteht.

Einschränkungen des Downgrads der WebView2-Runtime

Versionsbeschränkungen

Einschränkung Einzelheiten
Versionsbereich Es wird nur die Version N-1 oder N-2 der WebView2-Runtime relativ zur aktuellen Evergreen-Runtime-Version unterstützt. Ein Downgrade auf eine WebView2-Runtime, die früher als die beiden vorherigen Runtime-Versionen ist, wird abgelehnt.
Versionsformat Nur Hauptversionsnummern (nur Ziffern). Zeichenfolgen, Punkte oder Platzhalter der vollständigen Version sind ungültig.
Automatischer Ablauf Eine herabgestufte Version der WebView2-Runtime bleibt nur aktiv, solange sie sich innerhalb der beiden neuesten vorherigen Versionen befindet. Nach zwei aufeinanderfolgenden neuen Versionen der Runtime-Version über die angeheftete Version hinaus, läuft das Downgrade automatisch ab, und die App wird auf die neueste WebView2-Runtime zurückgesetzt.
Verfügbarkeit Das Downgrade-Feature ist nur für Microsoft Edge WebView2 Version 150 oder höher verfügbar.

Bereichsbeschränkungen

Einschränkung Einzelheiten
Nur für Unternehmen Nicht unterstützt auf Heimanwender- oder nicht verwalteten Geräten.
Nur auf Computerebene Richtlinien können nur auf der Ebene des lokalen Computers (HKEY_LOCAL_MACHINE (HKLM)) festgelegt werden. Das Festlegen der Downgrade-Richtlinie für den aktuellen Benutzer (HKEY_CURRENT_USER (HKCU)) wird nicht unterstützt. Es gibt keine Richtlinie auf Benutzerebene oder individuelle Kontrolle auf Benutzerebene.
Zielgruppen-Targeting nach App Kann nicht für alle WebView2-Apps ein unternehmensweites Downgrade durchführen. Jede WebView2-App muss individuell ausgerichtet sein.
Kein Entwicklersteuerelement Nur ein IT-Admin kann das Downgrade der WebView2-Runtime initiieren. Ein Entwickler kann kein Downgrade der WebView2-Runtime auslösen, z. B. über eine API.
Kein unbegrenztes Anheften Die Lösung unterstützt KEINE langfristige oder dauerhafte Anheftung von Versionen.

Einschränkungen des freigegebenen Benutzerdatenordners (Shared User Data Folder, UDF)

Der IT-Admin muss alle WebView2-Apps, die denselben Benutzerdatenordner (User Data Folder, UDF) gemeinsam nutzen, herabstufen, damit sie die gleiche WebView2-Runtime-Version verwenden.

WebView2-Apps können einen WebView2-Benutzerdatenordner (User Data Folder, UDF) freigeben, um den Browserstatus wiederzuverwenden. Nur sehr wenige Apps teilen sich einen Benutzerdatenordner (User Data Folder, UDF). Die einzigen bekannten Apps, die eine benutzerdefinierte Benutzerbindung gemeinsam nutzen, sind die Office-Suite-Apps: Excel, Word und PowerPoint.

Der Zugriff auf dieselbe UDF von verschiedenen WebView2-Runtimeversionen aus ist unsicher. Wenn WebView2-App A herabgestuft wird und WebView2-App B dieselbe UDF verwendet, aber nicht herabgestuft wird, schlagen sowohl WebView2-App A als auch WebView2-App B beim Start schnell fehl.

Risiken eines Downgrades der WebView2-Runtime

Sicherheitsrisiken

Risiko Beschreibung
Wieder eingeführte Sicherheitsrisiken Durch ein Downgrade werden gepatchte Sicherheitslücken, die in neueren Versionen behoben wurden, wieder eingeführt.
Abschwächung der Compliance Ältere Versionen können in regulierten Umgebungen gegen die Compliance verstoßen.
Erweiterte Angriffsfläche Die Verwaltung mehrerer heruntergestufter Versionen erhöht die Persistenz veralteter Clients.

Risiken für die Datenintegrität

Risiko Beschreibung
Speicherbeschädigung Ein Downgrade kann zu Beschädigungen oder Inkompatibilitäten führen, wenn sich Speicherformate, Schemas oder APIs zwischen den Versionen (Cookies, IndexedDB, Local Storage) geändert haben.
Schemakonflikte Im Gegensatz zum Edge-Browser, der Momentaufnahmen von Benutzerdaten verwendet, implementiert WebView2 keine Momentaufnahmen auf Plattformebene.
Verlust von Benutzerdaten Profilinstabilität und potenzieller Datenverlust bei inkompatiblen Speicherformaten.

Risiken der App-Kompatibilität

Risiko Beschreibung
Unterbrechungen von Featureabhängigkeiten Eine WebView2-App, die neuere WebView2-APIs oder -Verhaltensweisen verwendet, kann nach dem Downgrade der WebView2-Runtime fehlschlagen oder sich unvorhersehbar verhalten.
Leistungsregressionen Ältere Versionen der WebView2-Runtime können langsamere Seitenladevorgänge, höhere Speicherauslastung und beeinträchtigte Erfahrungen mit sich bringen.
Fehlfunktion der App Ein Downgrade der WebView2-Runtime kann dazu führen, dass eine WebView2-App aufgrund der Abhängigkeit von kürzlich eingeführten Features oder Renderingänderungen nicht mehr ordnungsgemäß funktioniert.

Operative Risiken

Risiko Beschreibung
Versionsfragmentierung Die Unterstützung eines Downgrades auf App-Ebene kann zu Versionsabweichungen zwischen Apps auf demselben Gerät führen.
Sedimentation Auf Geräten sammeln sich im Laufe der Zeit mehrere ältere Versionen an, was die Komplexität erhöht.
Erhöhte Datenträgerauslastung Eine zusätzliche WebView2-Runtime-Version wird Seite an Seite mit der aktuellen Evergreen WebView2-Runtime-Version installiert, wodurch zusätzlicher Speicherplatz auf jedem Gerät belegt wird.
Komplexität der Koordination Ein Downgrade erfordert eine sorgfältige Koordination zwischen dem IT-Admin, dem WebView2-App-Besitzer und dem Plattformteam.

Testen und Beheben von Problemen beim Downgrade der Runtime

Überprüfen, ob das Runtime-Downgrade angewendet wurde

Nachdem Sie die Herabstufungsrichtlinie für die WebView2-Runtime festgelegt und die WebView2-Ziel-App neu gestartet haben, gehen Sie wie folgt vor.

1. Überprüfen des versionierten Ordners

  1. Navigieren Sie im Explorer zu:C:\Program Files (x86)\Microsoft\EdgeWebView\Application\

  2. Vergewissern Sie sich, dass ein neuer Ordner angezeigt wird, der der herabgestuften Version entspricht (z. B 150.0.2178.0. ).

    Das Vorhandensein dieses versionierten Ordners weist darauf hin, dass der Edge Updater die herabgestufte WebView2-Runtime abgerufen und bereitgestellt hat.

2. Überprüfen Sie die Registrierungsrichtlinie

  1. Vergewissern Sie sich, dass der DowngradeVersion Schlüssel festgelegt wurde, unter: HKLM\Software\Policies\Microsoft\Edge\WebView2\DowngradeVersion

  2. Stellen Sie sicher, dass die Einträge mit der konfigurierten AppId → TargetVersionübereinstimmen.

3. Überprüfen Sie die BrowserExecutableFolder Weiterleitung
  • Die BrowserExecutableFolder Richtlinie sollte automatisch so festgelegt werden, dass die App auf den herabgestuften Runtime-Pfad verweist.

Auslösen einer erzwungenen Aktualisierung

Nach dem Festlegen der DowngradeVersion Richtlinie muss der Microsoft Edge Updater die Zielversion herunterladen. Standardmäßig geschieht dies innerhalb von ca. 1 Stunde (abgestimmt auf den Edge/WebView2-Updateaufgabenrhythmus).

So lösen Sie ein sofortiges Update aus:

  1. Öffnen Sie PowerShell als Administrator.

  2. Suchen Sie die Edge-Updateaufgabe:

    Get-ScheduledTask -TaskPath "\Microsoft\EdgeUpdate\*" | Select TaskName, TaskPath

  3. Führen Sie die Aufgabe aus:

    Start-ScheduledTask -TaskName "<task name from step 2>"

  4. Warten Sie einige Minuten, bis der Download abgeschlossen ist.

  5. Starten Sie die WebView2-App neu.

Diagnosetools für eine tiefergehende Problembehandlung

Die folgenden Tools dienen der Fehlerbehebung – sie sind nicht für die Standardüberprüfung erforderlich:

Tool Zweck
edge://webview2-internals Aktive WebView2-Prozesse anzeigen, verwendete Runtime-Version.
ETW-Ablaufverfolgung Mitschreiben von Low-Level-Diagnoseprotokollen für Update-/Downgrade-Ereignisse.
Ereignisanzeige Überprüfen Sie Anwendungsprotokolle auf WebView2-Aktualisierungsfehler oder Fehler bei der Richtlinienerzwingung.

Häufige Probleme und Lösung

Symptom Wahrscheinliche Ursache Lösung
App läuft noch in der neuesten Version App nicht neu gestartet. Starten Sie die WebView2-App neu (nicht den Computer).
Downgradeder Ordner wird nicht angezeigt Die Version liegt außerhalb des Bereichs "N-1 oder N-2". Stellen Sie sicher, dass die Zielversion zwischen den beiden neuesten vorherigen Versionen liegt.
App schlägt beim Starten schnell fehl (alle Apps teilen sich einen Benutzerdatenordner (User Data Folder, UDF)). Konflikt bei freigegebener UDF-Version. Führen Sie ein Downgrade aller Apps, die dieselbe UDF verwenden, auf dieselbe Version durch.
Richtlinie wird nicht wirksam. Falscher Schlüsselpfad oder falsches Wertformat. Überprüfen Sie den HKEY_LOCAL_MACHINE (HKLM)-Pfad, das Wertnamenformat (AUMID oder .exe) und das vierteilige numerische Format (z. B. 151.0.2178.0).
Mehrere Apps sind unerwartet betroffen. Ordner für freigegebene Benutzerdaten Identifizieren Sie die Benutzerdatenordnerfreigabe (User Data Folder, UDF), und stellen Sie sicher, dass alle betroffenen Apps ausgerichtet sind.
Das Downgrade wurde automatisch unerwartet rückgängig gemacht. Die angeheftete Version lag außerhalb des unterstützten Bereichs Es wird erwartet, dass das Downgrade der WebView2-Runtime abläuft, nachdem sich die Runtime-Version nicht mehr in der Version N-1 oder N-2 (den beiden früheren Versionen der Runtime) befindet.

Entfernen des Downgrades der WebView2-Runtime

Wichtig: Löschen Sie Registrierungsschlüssel nicht direkt. Verwenden Sie immer die Gruppenrichtlinie (GPO), um die Richtlinie zu deaktivieren, um eine saubere Entfernung sicherzustellen und verwaiste Konfigurationen zu vermeiden.

Wenn Gruppenrichtlinienobjekt zum Konfigurieren des Downgrades verwendet wurde:

  1. Öffnen Sie den Gruppenrichtlinien-Editor (gpedit.msc).

  2. Navigieren Sie zu: Administrative Vorlagen > für die Computerkonfiguration > Microsoft Edge WebView2

  3. Legen Sie "WebView2-Downgradeversion pro Anwendung konfigurieren" auf "Deaktiviert " oder "Nicht konfiguriert" fest.

  4. Starten Sie die WebView2-App neu.

    Die App wird beim nächsten Start auf die neueste Evergreen-Runtime rückgängig gemacht.

Option 2: Entfernen der Richtlinie über die Registrierung

Vorsicht: Die direkte Registrierungsmanipulation sollte nur verwendet werden, wenn die ursprüngliche Richtlinie über den Registrierungs-Editor festgelegt wurde. Wenn eine Gruppenrichtlinie (GPO) verwendet wurde, sollten Sie immer unter Verwendung von GPO rückgängig machen, um Konsistenz zu gewährleisten.

Wenn die Richtlinie ursprünglich direkt über die Registrierung festgelegt wurde (in der Produktion nicht empfohlen):

  1. Als Administrator öffnen regedit .

  2. Navigieren Sie zu: HKEY_LOCAL_MACHINE\Software\Policies\Microsoft\Edge\WebView2\DowngradeVersion

  3. Löschen Sie den bestimmten Wert (z. Bms-teams.exe.).

  4. Starten Sie die WebView2-App neu.

Option 3: Automatischer Ablauf

Das Downgrade läuft automatisch ab, wenn die angeheftete Version nicht mehr innerhalb der beiden neuesten vorherigen Versionen liegt:

  • Auslöser: Zwei weitere neue Evergreen-Versionen werden über die angeheftete Version hinaus veröffentlicht.

  • Verhalten: Der Microsoft Edge Updater setzt die entsprechenden Apps automatisch auf die neueste Laufzeit zurück.

  • Admin-Aktion erforderlich: Entfernen Sie die veraltete Richtlinie, sobald sie automatisch abläuft.

  • Beispiel: Wenn Sie ein Downgrade auf Version 145 durchführen, während 147 aktuell ist (145 ist N-2), und dann Version 148 veröffentlicht wird, liegt Version 145 jetzt drei Versionen hinter → Downgrade läuft automatisch ab.

Verhalten nach dem Rückgängig machen

Aktion Folgendes passiert:
Neustart der Anwendung Die WebView2-App holt die neueste WebView2-Runtime beim nächsten Start der App ab.
BrowserExecutableFolder Automatisch entfernt; die WebView2-App kehrt zur Verwendung des standardmäßigen WebView2-Laufzeitpfads zurück.
Herabgestufte Runtimebits Vom Edge-Updater im zeitplanmäßigen Rhythmus bereinigt.
Benutzerdaten Bleibt an Ort und Stelle; Es findet keine automatische Datenmigration statt.

Eskalieren und Kontaktieren des WebView2-Teams

Eskalationspfad:

  1. Der Enterprise-Admin kontaktiert Microsoft CSS.

  2. CSS behebt das Problem mithilfe dieses Artikels.

  3. Wenn es nicht behoben wird, eskaliert CSS das Problem an das WebView2 Platform-Team-ICM.

    Area Path: Edge\Web Experience\WebView2\Distribution

    Owning Service: Kundenvorfälle im Edge-Browser.

    Besitzerteam: Edge WebView2.

Siehe auch:

Weitere Informationen

Extern:

  • Last updated on