Eseguire il downgrade di WebView2 Runtime a una versione precedente

Se una nuova versione del runtime WebView2 introduce una regressione critica in un'app WebView2 specifica, un Amministrazione IT può eseguire il downgrade del runtime WebView2 per tale app a una versione precedente, usando il DowngradeVersion criterio, come soluzione temporanea.

Contenuto dettagliato:

Panoramica del downgrade aziendale

In un'azienda, l'Amministrazione IT può eseguire il downgrade del runtime WebView2 a una versione precedente, come misura temporanea, usando il DowngradeVersion criterio. Quando si usa Evergreen Runtime, se una nuova versione di runtime introduce una regressione critica, è probabile che ogni app WebView2 e ogni componente Windows che usa WebView2 Runtime venga influenzato. Enterprise Downgrade offre un approccio di mitigazione a breve termine per l'Amministrazione IT per ripristinare la produttività compromessa.

Il DowngradeVersion criterio è una funzionalità di downgrade della versione controllata che consente a un Amministrazione IT aziendale di ripristinare temporaneamente una specifica applicazione WebView2 (app WebView2) per l'uso di una versione precedente del runtime WebView2 tramite Criteri di gruppo quando una regressione critica interrompe le operazioni aziendali. Vedere DowngradeVersion in Microsoft Edge WebView2 - Criteri.

Il modello di distribuzione Evergreen prevede che WebView2 Runtime venga aggiornato automaticamente insieme a Microsoft Edge, in modo che l'app WebView2 venga sempre eseguita sulla versione più recente di WebView2 Runtime, senza alcun intervento manuale. Il runtime Evergreen WebView2 garantisce che l'app WebView2 ottenga automaticamente le patch di sicurezza e i miglioramenti delle funzionalità. L'Amministrazione IT aziendale non può disinstallare l'aggiornamento di WebView2 Runtime interessato.

WebView2 è un controllo del browser che consente alle applicazioni Windows, ad esempio Microsoft Teams, Outlook e software aziendale di terze parti, di incorporare il contenuto Web tramite il motore di rendering Microsoft Edge.

Come funziona il downgrade aziendale

  1. L'Amministrazione IT identifica che una nuova versione di WebView2 Runtime ha interrotto una specifica app WebView2.

  2. Il Amministrazione IT imposta un Criteri di gruppo che specifica che per questa app WebView2 usare una versione precedente specifica di WebView2 Runtime, anziché l'ultima WebView2 Runtime.

    È supportata solo la versione N-1 o N-2 di WebView2 Runtime rispetto alla versione Evergreen corrente di WebView2 Runtime. Il downgrade a una versione di WebView2 Runtime precedente alla versione N-2 viene rifiutato.

  3. Edge Updater scarica e installa la versione precedente di WebView2 Runtime affiancata all'attuale WebView2 Runtime.

  4. Il caricatore WebView2 reindirizza solo l'app WebView2 di destinazione al runtime WebView2 precedente.

  5. Tutte le altre app WebView2 nel dispositivo continuano a usare l'ultima versione di WebView2 Runtime; non sono interessati dal declassamento.

  6. Il downgrade scade automaticamente dopo che la versione aggiunta non è più inclusa nelle due versioni precedenti più recenti di WebView2 Runtime.

Perché esiste il downgrade aziendale

Enterprise Downgrade è uno strumento di recupero di ultima istanza. Il downgrade aziendale è mirato, limitato nel tempo e gestito dall'Amministrazione IT aziendale in collaborazione con i proprietari delle app WebView2. Il downgrade aziendale non è un meccanismo di aggiunta della versione.

Il downgrade aziendale fornisce un downgrade temporaneo della versione controllato dall'Amministrazione per la specifica app WebView2 interessata, mentre il team della piattaforma prepara una correzione appropriata. Il downgrade aziendale deve essere usato solo come misura di ripristino di ultima istanza, quando una regressione critica sta interrompendo attivamente le operazioni aziendali e nessun'altra prevenzione (come un hotfix, un flag di funzionalità o una sospensione degli aggiornamenti) può risolvere il problema in modo tempestivo. Il downgrade fa guadagnare tempo al team della piattaforma per fornire una soluzione adeguata; Il downgrade non sostituisce la spedizione di una soluzione adeguata.

Negli ambienti aziendali mission-critical, regressioni impreviste in WebView2 Runtime possono interrompere i flussi di lavoro aziendali senza rimedio immediato. Anche brevi interruzioni comportano una perdita di entrate, mancato rispetto degli SLA e un aumento dei costi operativi. Gli ambienti aziendali mission-critical includono, ad esempio:

  • Sistemi sanitari
  • Piattaforme di trading finanziario
  • Punto vendita al dettaglio
  • Servizi governativi

App WebView2 applicabili

Il downgrade aziendale del runtime WebView2 non influisce automaticamente su alcuna app WebView2. L'Amministrazione IT deve configurare in modo esplicito i DowngradeVersion criteri per un'app WebView2 specifica. Il criterio si applica quindi solo all'app WebView2 specifica.

È possibile scegliere come target i tipi di app WebView2 seguenti:

  • Qualsiasi app WebView2 Evergreen-Runtime in esecuzione su dispositivi Windows gestiti dall'organizzazione.

    • L'Amministrazione IT specifica il target in uno dei modi seguenti:

      • ID modello utente applicazione (AUMID, Application User Model ID) per le app con pacchetto o MSIX.
      • Il nome dell'eseguibile (ad esempio ms-teams.exe).

    • Se esistono sia una voce AUMID .exe che una voce name per la stessa app WebView2, la voce AUMID ha la precedenza.

Per trovare il .exe nome:

  1. Aprire Gestione attività e quindi a sinistra selezionare Dettagli.

  2. Trovare l'app WebView2 in esecuzione.

  3. Esaminare la colonna Nome per l'app WebView2, ad esempio ms-teams.exe o olk.exe.

I tipi seguenti di app WebView2 non sono interessati dal DowngradeVersion criterio:

  • App WebView2 non specificate nel DowngradeVersion criterio.

    • Tali app continuano a usare la versione più recente di WebView2 Evergreen Runtime.

  • App WebView2 in dispositivi consumer o non gestiti.

  • App WebView2 che usano un runtime WebView2 in bundle con app (versione fissa).

Configurazione e precedenza dei criteri

HKEY_CURRENT_USER (HKCU) non è supportato; si tratta solo di un criterio aziendale a livello di computer (HKEY_LOCAL_MACHINE (HKLM)).

Posizione Percorso
Criteri di gruppo (consigliati) Configurazione> computerModelli> amministrativiMicrosoft Edge WebView2>Configurare la versione di downgrade di WebView2 per applicazione
Registro di sistema HKLM\Software\Policies\Microsoft\Edge\WebView2\DowngradeVersion

Precedenza quando sono presenti più criteri (dal più alto al più basso):

  1. Criterio DowngradeVersion : vince sempre.

  2. BrowserExecutableFolder: se impostato in modo indipendente dall'Amministrazione IT.

  3. Runtime sempreverde predefinito : il più basso.

Se entrambi DowngradeVersion e BrowserExecutableFolder sono configurati in modo indipendente, DowngradeVersion ha la precedenza e sostituisce il BrowserExecutableFolder reindirizzamento.

Principi fondamentali del design

  • Gestito dall'amministrazione IT aziendale: solo gli amministratori IT possono avviare il downgrade tramite Criteri di gruppo. Gli sviluppatori e gli utenti finali non possono attivarlo.

  • Conformità del servizio di aggiornamento: Edge Updater scarica la versione richiesta, se necessario, e continua gli aggiornamenti normali per tutte le altre app.

  • Scadenza automatica: Una versione declassata rimane valida solo finché rientra nelle due versioni precedenti più recenti (N-1 o N-2). Una volta che due nuove versioni principali successive vengono rilasciate oltre alla versione declassata, il downgrade scade e l'app torna automaticamente all'ultimo runtime. Microsoft consiglia all'Amministrazione IT di rimuovere i criteri obsoleti dopo la scadenza automatica.

  • Targeting per app: Il downgrade viene applicato per app, non a livello di dispositivo. Ogni app WebView2 deve essere specificata singolarmente nel criterio.

Downgrade temporaneo del runtime WebView2

Aggiornamento del modello di criteri

Per aggiornare il modello di criterio:

  1. Passare a Scaricare e distribuire Microsoft Edge for Business.

  2. Nella sezione Scarica l'ultima cosa, fai clic su uno dei pulsanti seguenti:

    • Windows
    • macOS
    • Linux

  3. Fare clic su un download ... Collegamento ai criteri , ad esempio:

    • Scarica i criteri di Windows a 64 bit
    • Scarica i criteri a 32 bit di Windows
    • Scarica i criteri di Windows ARM64
    • Scarica Criteri universali di macOS
    • Scarica il criterio di Linux (.rpm)
    • Scarica Linux (.deb) Policy

    Viene visualizzata la finestra di dialogo Scarica file dei criteri di Microsoft Edge .

  4. Fai clic sul pulsante Accetta e scarica .

    Viene scaricato un file, ad esempio MicrosoftEdgePolicyTemplates.cab.

  5. In Microsoft Edge seleziona Impostazioni e altro (...), seleziona Download e quindi per il file scaricato fai clic su Apri cartella contenitore.

    In Windows si apre Esplora file con il file MicrosoftEdgePolicyTemplates.cab selezionato.

  6. Fare clic con il pulsante destro del mouse MicrosoftEdgePolicyTemplates.cabe quindi scegliere Apri.

    MicrosoftEdgePolicyTemplates.zip viene visualizzato.

  7. Fai clic con il pulsante destro del mouse MicrosoftEdgePolicyTemplates.zipe quindi seleziona Estrai.

    Viene visualizzata la finestra di dialogo Seleziona una destinazione .

  8. Selezionare la directory, ad esempio C:\Users\local-account\Downloads, quindi fare clic sul pulsante Estrai .

    Viene creata una cartella, simile alla seguente: C:\Users\local-account\Downloads\MicrosoftEdgePolicyTemplates.zip

  9. Selezionare a sinistra MicrosoftEdgePolicyTemplates.zipe quindi aprire la /windows/ directory a destra.

    Le cartelle /adm/ e /admx/ sono elencate.

  10. Copiare le cartelle /adm/ e /admx/ in una /PolicyDefinitions/ directory. Ad esempio, per Windows, copia le /adm/ cartelle e /admx/ in C:\Windows\PolicyDefinitions\.

    Viene visualizzata la finestra di dialogo Nega accesso alla cartella di destinazione con il messaggio "È necessario fornire l'autorizzazione di amministratore per copiare in questa cartella".

  11. Fai clic sul pulsante Continua .

    Viene visualizzata la finestra di dialogo Controllo dell'account utente .

  12. Immettere le credenziali di amministratore.

Opzione 1: Criteri di gruppo

Questo è l'approccio consigliato per gli ambienti aziendali. I Criteri di gruppo assicurano una gestione centralizzata e controllabile tra i dispositivi gestiti.

  1. Apri Editor criteri di gruppo (gpedit.msc).

  2. Passare a: Modelli > amministrativi di Configurazione > computer Microsoft Edge WebView2

  3. Trovare Configura la versione di downgrade di WebView2 per applicazione.

  4. Abilitare il criterio e immettere queste informazioni:

    • Nome: Identificatore dell'applicazione (AUMID). Oppure il .exe nome, ad esempio ms-teams.exe.

    • Valore: Numero di versione di destinazione composto da quattro parti, ad esempio 151.0.2178.0.

Opzione 2: editor del Registro di sistema (regedit)

Per la configurazione mirata su singoli computer. Richiede privilegi di amministratore locale.

  1. Apri regedit come amministratore.

  2. Passare a: HKEY_LOCAL_MACHINE\Software\Policies\Microsoft\Edge\WebView2

  3. Creare una nuova chiave denominata DowngradeVersion (se non esiste).

  4. All'interno della DowngradeVersion chiave, crea un nuovo String Value (REG_SZ):

    • Nome: AUMID o nome eseguibile (ad esempio ms-teams.exe).

    • Dati valore: Numero di versione principale di destinazione.

      • Impostare il valore sulla stringa della versione completa di destinazione usando il formato numerico in quattro parti (ad esempio 151.0.2178.0).

      • L'amministrazione IT può trovare il numero esatto di versione in quattro parti nelle note sulla versione di Microsoft Edge per il canale Stabile.

      • Valori di esempio:

        • Nome: ms-teams.exe, Valore: 151.0.2178.0
        • Nome: olk.exe, Valore: 152.0.2164.0

  5. Riavviare l'app WebView2 per applicare i criteri.

Esempio:

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

Note importanti

  • Solo HKEY_LOCAL_MACHINE (HKLM) è supportato; HKEY_CURRENT_USER (HKCU) viene ignorato.

  • I seguenti valori non sono supportati:

    • Valori solo principali (ad esempio 151).
    • Valori con caratteri jolly (ad esempio 151.*).
    • Valori che non sono versioni numeriche esatte in quattro parti.

  • Il caricatore WebView2 risolve la directory di installazione di runtime solo quando esiste una cartella che corrisponde esattamente alla versione completa configurata. Ad esempio, 151.0.2178.0 deve corrispondere esattamente a 151.0.2178.0.

    Se non viene trovata alcuna cartella esatta corrispondente, il criterio non ha alcun effetto e per impostazione predefinita viene utilizzato il criterio o Evergreen BrowserExecutableFolder Runtime (il runtime ad aggiornamento automatico predefinito).

  • Edge Updater scaricherà automaticamente la versione richiesta se soddisfa le condizioni N-1 e/o N-2. L'Amministrazione IT non deve pre-installare le cartelle delle versioni su disco.

  • Non è necessario riavviare il computer, ma è necessario riavviare l'app WebView2 e potrebbe essere necessario attendere fino a 1 ora per rendere effettivo il downgrade.

  • Latenza dei criteri per l'app WebView2: le modifiche diventano effettive entro 1 ora dalla distribuzione. Questo è allineato con la frequenza delle attività di aggiornamento di Microsoft Edge e WebView2. Per attivare un aggiornamento forzato, vedere Attivazione di un aggiornamento forzato, di seguito.

  • Il downgrade runtime sull'applicazione dei criteri sostituisce quanto segue:

    • Finestre di manutenzione.
    • Intervalli di aggiornamento prolungati.
    • Timestamp di ultimo controllo memorizzati nella cache.

Flusso di processo: come viene implementato il downgrade

  1. L'Amministrazione IT imposta i criteri usando i Criteri di gruppo, specificando e AppIdTargetVersion.

  2. Edge Updater legge il criterio e verifica che TargetVersion sia compreso tra N-1 e N-2.

  3. Edge Updater scarica la versione declassata di WebView2 Runtime, se necessario, come installazione affiancata.

  4. Lo strumento di aggiornamento di Edge imposta BrowserExecutableFolder i criteri per l'app di destinazione per reindirizzarla alla versione specificata di WebView2 Runtime.

  5. Edge Updater mantiene il mapping finché la versione di downgrade del runtime WebView2 rimane all'interno dell'intervallo supportato.

  6. Quando la versione aggiunta del runtime WebView2 non rientra nell'intervallo supportato o il criterio viene rimosso, lo strumento di aggiornamento di Edge esegue la pulizia e ripristina l'app WebView2 all'uso della versione più recente di WebView2 Runtime.

Se un criterio di downgrade di WebView2 Runtime è attivo, ma la versione di destinazione di WebView2 Runtime non è ancora stata scaricata (ad esempio a causa di vincoli di rete o del disco), l'app WebView2 continua a usare l'ultima versione di WebView2 Runtime, fino a quando non è presente il precedente WebView2 Runtime. L'app WebView2 non verrà mancata per l'avvio solo perché la versione declassata di WebView2 Runtime è in attesa di download.

Limitazioni del downgrade del runtime WebView2

Limitazioni della versione

Limitazione Dettaglio
Intervallo di versioni È supportata solo la versione N-1 o N-2 di WebView2 Runtime rispetto alla versione corrente di Evergreen Runtime. Il downgrade a un runtime WebView2 precedente alle due versioni di runtime precedenti viene rifiutato.
Formato versione Solo i numeri di versione principali (solo cifre). Le stringhe, i punti o i caratteri jolly della versione completa non sono validi.
Scadenza automatica Una versione di downgrade di WebView2 Runtime rimane attiva solo finché si trova all'interno delle due versioni precedenti più recenti. Dopo due nuove versioni successive della versione Runtime oltre alla versione aggiunta, il downgrade scade automaticamente e l'app torna alla versione più recente di WebView2 Runtime.
Disponibilità La funzionalità di downgrade è disponibile solo per Microsoft Edge WebView2 versione 150 o successiva.

Limitazioni dell'ambito

Limitazione Dettaglio
Solo per le aziende Non è supportato nei dispositivi consumer o non gestiti.
Solo a livello di computer Il criterio può essere impostato solo a livello del computer locale (HKEY_LOCAL_MACHINE (HKLM)). L'impostazione del criterio di downgrade per l'utente corrente (HKEY_CURRENT_USER (HKCU)) non è supportata; Non esiste alcun criterio a livello di utente o controllo a livello di utente individuale.
Targeting per app Non è possibile eseguire il downgrade a livello aziendale in tutte le app WebView2. Ogni app WebView2 deve essere destinata individualmente.
Nessun controllo dello sviluppatore Solo un Amministrazione IT può avviare il downgrade di WebView2 Runtime. Uno sviluppatore non può attivare il downgrade del runtime WebView2, ad esempio tramite un'API.
Nessun fissaggio a tempo indeterminato La soluzione NON supporta l'aggiunta permanente o a lungo termine della versione.

Vincoli della cartella dei dati degli utenti condivisi

L'Amministrazione IT deve eseguire il downgrade di tutte le app WebView2 che condividono la stessa cartella dei dati dell'utente (UDF), in modo da usare la stessa versione di WebView2 Runtime.

Le app WebView2 possono condividere una cartella dei dati utente WebView2 per riutilizzare lo stato del browser. Pochissime app condividono una cartella dei dati dell'utente (UDF); le uniche app note che condividono una funzione definita dall'utente sono le app della famiglia di prodotti Office: Excel, Word e PowerPoint.

L'accesso alla stessa funzione definita dall'utente da versioni diverse di WebView2 Runtime non è sicuro. Se viene eseguito il downgrade dell'app WebView2 A e l'app B di WebView2 condivide la stessa funzione definita dall'utente ma non viene eseguito il downgrade, sia l'app A che l'app B di WebView2 avranno esito negativo all'avvio.

Rischi del downgrade del runtime WebView2

Rischi per la sicurezza

Rischio Descrizione
Vulnerabilità reintrodotte Il downgrade reintroduce le vulnerabilità corrette nelle versioni più recenti.
Indebolimento della conformità Le versioni precedenti possono violare la conformità in ambienti regolamentati.
Superficie di attacco espansa La gestione di più versioni declassate aumenta la persistenza dei client obsoleti.

Rischi per l'integrità dei dati

Rischio Descrizione
Danneggiamento dell'archiviazione Il downgrade può causare danneggiamento o incompatibilità se i formati di archiviazione, gli schemi o le API sono stati modificati tra le versioni (cookie, IndexedDB, archiviazione locale).
Mancata corrispondenza tra gli schemi A differenza del browser Edge che utilizza gli snapshot dei dati utente, WebView2 non implementa lo snapshot a livello di piattaforma.
Perdita dei dati utente Instabilità del profilo e potenziale perdita di dati se i formati di archiviazione non sono compatibili.

Rischi per la compatibilità delle app

Rischio Descrizione
Interruzioni delle dipendenze delle funzionalità Un'app WebView2 che usa API WebView2 più recenti o comportamenti potrebbe non riuscire o comportarsi in modo imprevedibile dopo il downgrade del runtime WebView2.
Regressioni del rendimento Le versioni precedenti di WebView2 Runtime potrebbero introdurre caricamenti di pagina più lenti, maggiore utilizzo della memoria ed esperienze ridotte.
Malfunzionamento dell'app Il downgrade del runtime WebView2 può causare il malfunzionamento di un'app WebView2, a causa della dipendenza dalle funzionalità introdotte di recente o dalle modifiche al rendering.

Rischi operativi

Rischio Descrizione
Frammentazione delle versioni Il supporto del downgrade a livello di app può causare la deriva della versione tra app nello stesso dispositivo.
Sedimentazione Più versioni precedenti si accumulano sui dispositivi nel tempo, aumentando la complessità.
Maggiore utilizzo del disco Un'ulteriore versione di WebView2 Runtime viene installata affiancata alla versione Evergreen WebView2 Runtime corrente, consumando spazio su disco aggiuntivo in ogni dispositivo.
Complessità del coordinamento Il downgrade richiede un attento coordinamento tra l'Amministrazione IT, il proprietario dell'app WebView2 e il team della piattaforma.

Test e risoluzione dei problemi relativi al downgrade del runtime

Verifica dell'applicazione del downgrade di runtime

Dopo aver impostato il criterio di downgrade di WebView2 Runtime e aver riavviato l'app WebView2 di destinazione, eseguire le operazioni seguenti.

1. Controllare la cartella con versione

  1. In Esplora file passa a:C:\Program Files (x86)\Microsoft\EdgeWebView\Application\

  2. Verifica che venga visualizzata una nuova cartella corrispondente alla versione declassata, ad esempio 150.0.2178.0).

    La presenza di questa cartella con versione indica che lo strumento di aggiornamento Edge ha recuperato ed eseguito un'installazione temporanea del runtime WebView2 declassato.

2. Controllare i criteri del Registro di sistema

  1. Verificare che la DowngradeVersion chiave sia impostata, in: HKLM\Software\Policies\Microsoft\Edge\WebView2\DowngradeVersion

  2. Verificare che le voci corrispondano all'→ configurato AppId . TargetVersion

3. Controlla il BrowserExecutableFolder reindirizzamento
  • Il BrowserExecutableFolder criterio deve essere impostato automaticamente per indirizzare l'app al percorso di runtime declassato.

Attivazione di un aggiornamento forzato

Dopo aver impostato il DowngradeVersion criterio, lo strumento di aggiornamento di Edge deve scaricare la versione di destinazione. Per impostazione predefinita, ciò si verifica entro circa 1 ora (allineato con la frequenza dell'attività di aggiornamento di Edge/WebView2).

Per attivare un aggiornamento immediato:

  1. Aprire PowerShell come amministratore.

  2. Individuare l'attività di aggiornamento di Edge:

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

  3. Eseguire l'attività:

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

  4. Attendere alcuni minuti per il completamento del download.

  5. Riavviare l'app WebView2.

Strumenti di diagnostica per una risoluzione dei problemi più approfondita

Gli strumenti seguenti servono per la risoluzione dei problemi , ma non sono necessari per la verifica standard:

Strumento Scopo
edge://webview2-internals Visualizzare i processi WebView2 attivi, la versione di runtime in uso.
Traccia ETW Trascrivi log di diagnostica di basso livello per gli eventi di aggiornamento/downgrade.
Visualizzatore eventi Verificare la presenza di errori di aggiornamento di WebView2 o errori di imposizione dei criteri nei registri applicazioni.

Problemi comuni e risoluzione

Sintomo Causa probabile Risoluzione
App ancora in esecuzione nell'ultima versione App non riavviata. Riavviare l'app WebView2 (non il computer).
La cartella declassata non viene visualizzata La versione non è compresa nell'intervallo "N-1 o N-2". Verificare che la versione di destinazione sia all'interno delle due versioni precedenti più recenti.
L'app non riesce rapidamente all'avvio (tutte le app condividono una cartella dati utente)). Mancata corrispondenza della versione della funzione definita dall'utente condivisa. Eseguire il downgrade di tutte le app che usano la stessa funzione definita dall'utente alla stessa versione.
Criterio non in vigore. Formato del valore o del percorso della chiave non corretto. Verificare il percorso del HKEY_LOCAL_MACHINE (HKLM), il formato del nome del valore (AUMID o .exe) e il formato numerico in quattro parti (ad esempio 151.0.2178.0).
Più app sono interessate in modo imprevisto. Cartella dati utente condivisi Identificare la condivisione delle cartelle dei dati utente e assicurarsi che tutte le app interessate siano allineate.
Il downgrade è stato ripristinato automaticamente in modo imprevisto. La versione aggiunta non è compresa nell'intervallo supportato È previsto che il downgrade del runtime WebView2 scada dopo che la versione del runtime non è più all'interno della versione N-1 o N-2 (le due versioni precedenti del runtime).

Rimozione del downgrade del runtime WebView2

Importante: non eliminare direttamente le chiavi del Registro di sistema. Utilizzare sempre i criteri di gruppo (GPO) per disabilitare il criterio, garantire la rimozione pulita ed evitare la configurazione orfana.

Se è stato usato l'oggetto Criteri di gruppo per configurare il downgrade:

  1. Apri Editor criteri di gruppo (gpedit.msc).

  2. Passare a: Modelli > amministrativi di Configurazione > computer Microsoft Edge WebView2

  3. Impostare "Configura la versione di downgrade di WebView2 per applicazione" su Disabilitato o Non configurato.

  4. Riavviare l'app WebView2.

    Al prossimo avvio, l'app tornerà alla versione più recente di Evergreen Runtime.

Opzione 2: Rimuovere il criterio dal Registro di sistema

Attenzione: la manipolazione diretta del Registro di sistema deve essere utilizzata solo se il criterio originale è stato impostato tramite l'editor del Registro di sistema. Se sono stati usati Criteri di gruppo (GPO), ripristinarli sempre usando GPO, per garantire la coerenza.

Se il criterio è stato originariamente impostato direttamente tramite il Registro di sistema (scelta non consigliata in produzione):

  1. Apri regedit come amministratore.

  2. Passare a: HKEY_LOCAL_MACHINE\Software\Policies\Microsoft\Edge\WebView2\DowngradeVersion

  3. Eliminare il valore specifico (ad esempioms-teams.exe).

  4. Riavviare l'app WebView2.

Opzione 3: scadenza automatica

Il downgrade scade automaticamente quando la versione aggiunta non è più inclusa nelle due versioni precedenti più recenti:

  • Grilletto: Due nuove versioni di Evergreen successive vengono rilasciate oltre alla versione bloccata.

  • Comportamento: Edge Updater ripristina automaticamente le app applicabili al runtime più recente.

  • Intervento dell'amministratore necessario: rimuovere i criteri non aggiornati dopo la scadenza automatica.

  • Esempio: Se esegui il downgrade alla versione 145 mentre la versione 147 è corrente (145 è N-2) e quindi alla versione 148, la versione 145 è ora indietro di tre versioni rispetto alla → il downgrade scade automaticamente.

Comportamento post-ripristino

Azione Cosa accade
Riavvio dell'applicazione L'app WebView2 preleva l'ultimo runtime WebView2 durante il successivo avvio dell'app.
BrowserExecutableFolder Rimosso automaticamente; l'app WebView2 torna a usare il percorso di runtime WebView2 predefinito.
Bit di runtime sottoposti a downgrade Pulizia da parte di Edge Updater a cadenza pianificata.
Dati utente Rimane al suo posto; Non viene eseguita alcuna migrazione automatica dei dati.

Escalation e contatto del team WebView2

Percorso di inoltro:

  1. L'Amministrazione aziendale contatta Microsoft CSS.

  2. CSS risolve il problema utilizzando questo articolo.

  3. Se non risolto, CSS inoltra il problema all'ICM del team della piattaforma WebView2.

    Percorso dell'area: Edge\Web Experience\WebView2\Distribution

    Servizio proprietario: eventi imprevisti dei clienti del browser Edge.

    Team proprietario: Edge WebView2.

Vedere anche:

Vedere anche

Esterno:

  • Last updated on