Rétrograder le runtime WebView2 vers une version antérieure

Si une nouvelle version du runtime WebView2 introduit une régression critique dans une application WebView2 spécifique, un Administration informatique peut rétrograder le runtime WebView2 de cette application vers une version précédente, à l’aide de la DowngradeVersion stratégie, en tant que solution temporaire.

Contenu détaillé :

Vue d’ensemble de la rétrogradation d’entreprise

Dans une entreprise, le Administration informatique peut rétrograder le runtime WebView2 vers une version antérieure, en tant que mesure temporaire, en utilisant la DowngradeVersion stratégie. Lors de l’utilisation d’Evergreen Runtime, si une nouvelle version du Runtime introduit une régression critique, chaque application WebView2 et chaque composant Windows qui utilise le runtime WebView2 sont susceptibles d’être affectés. Enterprise Downgrade offre une approche d’atténuation à court terme permettant à l’Administration informatique de restaurer la productivité affectée.

La DowngradeVersion stratégie est une fonctionnalité de mise à niveau de version contrôlée qui permet à un Administration informatique d’entreprise de rétablir temporairement une application WebView2 spécifique (application WebView2) pour utiliser une version précédente du runtime WebView2 via stratégie de groupe lorsqu’une régression critique perturbe les opérations de l’entreprise. Voir Version antérieure dans Microsoft Edge WebView2 - Policies.

Le modèle de distribution Evergreen signifie que le runtime WebView2 est mis à jour automatiquement en même temps que Microsoft Edge, de sorte que l’application WebView2 s’exécute toujours sur la dernière version du runtime WebView2, sans intervention manuelle. Le runtime Evergreen WebView2 garantit que l’application WebView2 obtient automatiquement les correctifs de sécurité et les améliorations des fonctionnalités. L’Administration informatique de l’entreprise ne peut pas désinstaller la mise à jour du runtime WebView2 concernée.

WebView2 est un contrôle de navigateur qui permet aux applications Windows (telles que Microsoft Teams, Outlook et les logiciels d’entreprise tiers) d’incorporer du contenu web à l’aide du moteur de rendu Microsoft Edge.

Fonctionnement du passage à une version antérieure d’entreprise

  1. Le Administration informatique identifie qu’une nouvelle version de WebView2 Runtime a endommagé une application WebView2 spécifique.

  2. L’Administration informatique définit une stratégie de groupe qui spécifie que, pour cette application WebView2, utilisez une version antérieure spécifique du runtime WebView2, au lieu du dernier runtime WebView2.

    Seule la version N-1 ou N-2 de WebView2 Runtime par rapport à la version actuelle d’Evergreen WebView2 Runtime est prise en charge. Le passage à une version du runtime WebView2 antérieure à la version N-2 est rejeté.

  3. L’outil de mise à jour Edge télécharge et installe l’ancienne version du runtime WebView2 côte à côte avec le runtime WebView2 actuel.

  4. Le chargeur WebView2 redirige uniquement l’application WebView2 ciblée vers l’ancien runtime WebView2.

  5. Toutes les autres applications WebView2 sur l’appareil continuent d’utiliser la dernière version WebView2 Runtime ; ils ne sont pas affectés par la rétrogradation.

  6. La rétrogradation expire automatiquement une fois que la version épinglée ne se trouve plus dans les deux versions précédentes les plus récentes du runtime WebView2.

Pourquoi la rétrogradation d’entreprise existe-t-elle ?

Enterprise Downgrade est un outil de récupération de dernier recours. Enterprise Downgrade est ciblé, limité dans le temps et géré par le Administration informatique de l’entreprise en partenariat avec les propriétaires d’applications WebView2. Enterprise Downgrade n’est pas un mécanisme d’épinglage de version.

Enterprise Grade fournit un passage à une version antérieure temporaire, contrôlée par l’Administration, pour l’application WebView2 spécifique concernée, pendant que l’équipe de plateforme prépare un correctif approprié. La rétrogradation d’entreprise ne doit être utilisée qu’en dernier recours, lorsqu’une régression critique perturbe activement les opérations de l’entreprise et qu’aucune autre atténuation (telle qu’un correctif logiciel, un indicateur de fonctionnalité ou une pause de mise à jour) ne peut résoudre le problème en temps voulu. La rétrogradation permet à l’équipe de la plate-forme de gagner du temps pour livrer un correctif approprié ; La rétrogradation ne remplace pas l’envoi d’un correctif approprié.

Dans les environnements d’entreprise critiques, des régressions inattendues dans le runtime WebView2 peuvent interrompre les flux de travail de l’entreprise sans remède immédiat. Même de brèves pannes entraînent une perte de revenus, des SLA manqués et une augmentation des coûts opérationnels. Les environnements d’entreprise critiques comprennent, par exemple :

  • Systèmes de santé
  • Plateformes de trading financier
  • Point de vente au détail
  • Services gouvernementaux

Applications WebView2 applicables

La mise à niveau d’entreprise du runtime WebView2 n’affecte pas automatiquement les applications WebView2. Le Administration informatique doit configurer explicitement la DowngradeVersion stratégie pour une application WebView2 spécifique. La stratégie s’applique ensuite uniquement à cette application WebView2 spécifique.

Les types d’applications WebView2 suivants peuvent être ciblés :

  • Toute application WebView2 Evergreen-Runtime exécutée sur des appareils Windows gérés par l’entreprise.

    • L’Administration informatique spécifie la cible en procédant comme suit :

      • ID de modèle utilisateur de l’application (AUMID) pour les applications empaquetées/MSIX.
      • Nom de l’exécutable (par exemple, ms-teams.exe).

    • Si une AUMID et .exe une entrée de nom existent pour la même application WebView2, l’entrée AUMID est prioritaire.

Pour trouver le .exe nom :

  1. Ouvrez le Gestionnaire des tâches, puis sur la gauche, sélectionnez Détails.

  2. Recherchez l’application WebView2 en cours d’exécution.

  3. Examinez la colonne Nom de l’application WebView2, telle que ms-teams.exe ou olk.exe.

Les types suivants d’applications WebView2 ne sont pas affectés par la DowngradeVersion politique :

  • Applications WebView2 non spécifiées dans la DowngradeVersion stratégie.

    • Ces applications continuent d’utiliser le dernier runtime WebView2 Evergreen.

  • Applications WebView2 sur des appareils grand public ou des appareils non gérés.

  • Applications WebView2 qui utilisent un runtime WebView2 groupé (version fixe).

Configuration et priorité des stratégies

HKEY_CURRENT_USER (HKCU) n’est pas pris en charge ; Il s’agit uniquement d’une stratégie d’entreprise au niveau de l’ordinateur (HKEY_LOCAL_MACHINE (HKLM)).

Location Chemin d'accès
Stratégie de groupe (recommandé) Ordinateur configuration>Modèles >d’administrationMicrosoft Edge WebView2>Configurer la version antérieure de WebView2 par application
Registry HKLM\Software\Policies\Microsoft\Edge\WebView2\DowngradeVersion

Priorité lorsque plusieurs stratégies existent (du plus haut au plus bas) :

  1. Stratégie DowngradeVersion — gagne toujours.

  2. BrowserExecutableFolder — s’il est défini indépendamment par l’Administration informatique.

  3. Runtime Evergreen par défaut : le plus bas.

Si les deux DowngradeVersion et BrowserExecutableFolder sont configurés indépendamment, DowngradeVersion prévaut et remplace la BrowserExecutableFolder redirection.

Principes de conception de base

  • Axé sur l’Administration informatique de l’entreprise : seuls les administrateurs informatiques peuvent initier la mise à niveau vers une version antérieure via la stratégie de groupe. Les développeurs et les utilisateurs finaux ne peuvent pas le déclencher.

  • Conformité du service de mise à jour : Le programme de mise à jour Edge télécharge la version requise si nécessaire et poursuit les mises à jour normales pour toutes les autres applications.

  • Expiration automatique : Une version rétrogradée ne reste valable que tant qu’elle se situe dans les deux versions précédentes les plus récentes (N-1 ou N-2). Une fois que deux nouvelles versions majeures ultérieures sont publiées au-delà de la version rétrogradée, la rétrogradation expire et l’application revient automatiquement au dernier Runtime. Microsoft recommande au Administration informatique de supprimer la stratégie obsolète après l’expiration automatique de celle-ci.

  • Ciblage par application : La rétrogradation est appliquée par application, et non par appareil. Chaque application WebView2 doit être spécifiée individuellement dans la stratégie.

Rétrogradation temporaire du runtime WebView2

Mise à jour du modèle de stratégie

Pour mettre à jour le modèle de stratégie :

  1. Accédez à Télécharger et déployer Microsoft Edge for Business.

  2. Dans la section Télécharger le dernier, cliquez sur l’un des boutons suivants :

    • Windows
    • macOS
    • Linux

  3. Cliquez sur un Télécharger ... Lien de stratégie , tel que :

    • Télécharger la stratégie Windows 64 bits
    • Télécharger la stratégie Windows 32 bits
    • Télécharger la stratégie ARM64 de Windows
    • Télécharger la stratégie universelle macOS
    • Télécharger la stratégie Linux (.rpm)
    • Télécharger la stratégie Linux (.deb)

    La boîte de dialogue Télécharger le fichier de stratégie Microsoft Edge s’ouvre.

  4. Cliquez sur le bouton Accepter et télécharger .

    Un fichier est téléchargé, tel que MicrosoftEdgePolicyTemplates.cab.

  5. Dans Microsoft Edge, sélectionnez Paramètres et plus (...), sélectionnez Téléchargements, puis, pour le fichier téléchargé, cliquez sur Ouvrir le dossier contenant.

    Sous Windows, l’Explorateur de fichiers s’ouvre, avec le fichier MicrosoftEdgePolicyTemplates.cab sélectionné.

  6. Cliquez avec le bouton droit MicrosoftEdgePolicyTemplates.cab, puis sélectionnez Ouvrir.

    MicrosoftEdgePolicyTemplates.zip apparaît.

  7. Cliquez avec le bouton droit MicrosoftEdgePolicyTemplates.zip, puis sélectionnez Extraire.

    La boîte de dialogue Sélectionner une destination s’ouvre.

  8. Sélectionnez le répertoire, par exemple C:\Users\local-account\Downloads, puis cliquez sur le bouton Extraire .

    Un dossier est créé, par exemple : C:\Users\local-account\Downloads\MicrosoftEdgePolicyTemplates.zip

  9. Sur la gauche, sélectionnez MicrosoftEdgePolicyTemplates.zip, puis sur la droite, ouvrez le /windows/ répertoire.

    Les dossiers /adm/ et /admx/ sont répertoriés.

  10. Copiez les dossiers /adm/ et /admx/ placez-les dans un /PolicyDefinitions/ répertoire. Par exemple, pour Windows, copiez les /adm/ dossiers et /admx/ vers C:\Windows\PolicyDefinitions\.

    La boîte de dialogue Accès au dossier de destination refusé s’ouvre, indiquant « Vous devez fournir l’autorisation d’administrateur pour copier dans ce dossier ».

  11. Cliquez sur le bouton Continuer .

    La boîte de dialogue Contrôle de compte d’utilisateur s’ouvre.

  12. Entrez les informations d’identification d’administrateur.

Option 1 : Stratégie de groupe (GPO)

Il s’agit de l’approche recommandée pour les environnements d’entreprise. La stratégie de groupe garantit une gestion centralisée et vérifiable sur les appareils gérés.

  1. Ouvrez l’éditeur de stratégie de groupe (gpedit.msc).

  2. Accédez à : Configuration > ordinateur Modèles > d’administration Microsoft Edge WebView2

  3. Recherchez Configurer la version antérieure WebView2 par application.

  4. Activez la stratégie et entrez les informations suivantes :

    • Nom : Identificateur de l’application (AUMID). Ou le .exe nom, comme ms-teams.exe.

    • Valeur : Numéro de version cible en quatre parties (par exemple, 151.0.2178.0).

Option 2 : Éditeur du Registre (regedit)

Pour une configuration ciblée sur des machines individuelles. Nécessite des privilèges d’administrateur local.

  1. Ouvrir regedit en tant qu’administrateur.

  2. Accédez à : HKEY_LOCAL_MACHINE\Software\Policies\Microsoft\Edge\WebView2

  3. Créez une nouvelle clé nommée DowngradeVersion (si elle n’existe pas).

  4. A l’intérieur de la DowngradeVersion clé, créez un nouveau String Value (REG_SZ):

    • Nom de la valeur : AUMID ou nom de l’exécutable (par ms-teams.exeexemple, ).

    • Données de la valeur : Numéro de version majeure cible.

      • Définissez la valeur sur la chaîne de version complète cible à l’aide du format numérique en quatre parties (par exemple, 151.0.2178.0).

      • L’Administration informatique peut trouver le numéro exact de la version en quatre parties dans les notes de publication de Microsoft Edge pour le canal stable.

      • Exemples de valeurs :

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

  5. Redémarrez l’application WebView2 pour que la stratégie prenne effet.

Exemple :

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

Remarques importantes

  • Seul HKEY_LOCAL_MACHINE (HKLM) est pris en charge ; HKEY_CURRENT_USER (HKCU) est ignoré.

  • Les valeurs suivantes ne sont pas prises en charge :

    • Valeurs majeures uniquement (par exemple, 151).
    • Valeurs génériques (par exemple, 151.*).
    • Valeurs qui ne sont pas des versions numériques exactes en quatre parties.

  • Le chargeur WebView2 résout le répertoire d’installation du runtime uniquement lorsqu’il existe un dossier correspondant exactement à la version complète configurée. Par exemple, 151.0.2178.0 doit correspondre exactement à 151.0.2178.0.

    Si aucun dossier correspondant exactement n’est trouvé, la stratégie n’a aucun effet et le runtime utilise par défaut la BrowserExecutableFolder stratégie ou Evergreen Runtime (le runtime par défaut de mise à jour automatique).

  • L’outil de mise à jour Edge télécharge automatiquement la version requise si elle remplit les conditions N-1 et/ou N-2. Le Administration informatique n’a pas besoin de préconfigurer les dossiers de version sur disque.

  • Aucun redémarrage de la machine n’est nécessaire, mais l’application WebView2 doit être redémarrée, et la prise d’effet à la version antérieure peut prendre jusqu’à 1 heure.

  • Latence de la stratégie pour l’application WebView2 : Les modifications prennent effet dans l’heure qui suit leur déploiement. Ceci est aligné sur la cadence des tâches de mise à jour de Microsoft Edge et WebView2. Pour déclencher une mise à jour forcée, consultez Déclenchement d’une mise à jour forcée, ci-dessous.

  • L’application de la stratégie de rétrogradation runtime remplace les éléments suivants :

    • Fenêtres de maintenance.
    • Intervalles de mise à jour étendus.
    • Horodatages de la dernière case activée mis en cache.

Flux de processus : comment mettre en œuvre la rétrogradation

  1. L’Administration informatique définit la stratégie à l’aide d’une stratégie de groupe, en spécifiant les valeurs et TargetVersion.AppId

  2. Le programme de mise à jour Edge lit la stratégie et la valide TargetVersion dans N-1 ou N-2.

  3. Le programme de mise à jour Edge télécharge la version antérieure du runtime WebView2, si nécessaire, en tant qu’installation côte à côte.

  4. Le programme de mise à jour Edge définit la BrowserExecutableFolder stratégie pour l’application cible afin de la rediriger vers la version spécifiée du runtime WebView2.

  5. Le programme de mise à jour Edge conserve le mappage tant que la version rétrogradée du runtime WebView2 reste dans la plage prise en charge.

  6. Lorsque la version épinglée du runtime WebView2 se situe en dehors de la plage prise en charge ou que la stratégie est supprimée, le programme de mise à jour Edge nettoie et rétablit l’application WebView2 pour qu’elle utilise la dernière version du runtime WebView2.

Si une stratégie de rétrogradation du runtime WebView2 est active, mais que la version cible du runtime WebView2 n’est pas encore téléchargée (par exemple, en raison de contraintes réseau ou de disque), l’application WebView2 continue d’utiliser le dernier runtime WebView2, jusqu’à ce que le Runtime WebView2 antérieur soit présent. L’application WebView2 ne manquera pas de se lancer uniquement parce que la version rétrogradée du runtime WebView2 est en attente de téléchargement.

Limitations de la rétrogradation du runtime WebView2

Limitations de version

Limitation Détail
Plage de versions Seule la version N-1 ou N-2 du runtime WebView2 par rapport à la version actuelle du runtime Evergreen est prise en charge. Le passage à un runtime WebView2 antérieur aux deux versions précédentes du runtime est rejeté.
Format de version Uniquement les numéros de version principaux (chiffres uniquement). Les chaînes de version complète, les points ou les caractères génériques ne sont pas valides.
Expiration automatique Une version rétrogradée de WebView2 Runtime ne reste active que lorsqu’elle se trouve dans les deux versions précédentes les plus récentes. Après deux nouvelles versions ultérieures du runtime au-delà de la version épinglée, la rétrogradation expire automatiquement et l’application revient au dernier runtime WebView2.
Disponibilité La fonctionnalité de mise à niveau vers une version antérieure est uniquement disponible pour Microsoft Edge WebView2 version 150 ou ultérieure.

Limites de portée

Limitation Détail
Entreprise uniquement Non pris en charge sur les appareils grand public ou non gérés.
Au niveau de l’ordinateur uniquement La stratégie ne peut être définie qu’au niveau de l’ordinateur local (HKEY_LOCAL_MACHINE (HKLM)). La définition de la stratégie de passage à une version antérieure pour l’utilisateur actuel (HKEY_CURRENT_USER (HKCU)) n’est pas prise en charge ; Il n’existe aucune stratégie au niveau de l’utilisateur ou contrôle individuel au niveau de l’utilisateur.
Ciblage par application Impossible d’effectuer un passage à une version antérieure à l’échelle de l’entreprise sur toutes les applications WebView2. Chaque application WebView2 doit être ciblée individuellement.
Aucun contrôle de développeur Seul un Administration informatique peut initier la rétrogradation du runtime WebView2. Un développeur ne peut pas déclencher une rétrogradation du runtime WebView2, par exemple via une API.
Pas d’épinglage indéfini La solution ne prend PAS en charge l’épinglage de version à long terme ou permanent.

Contraintes de dossier de données utilisateur partagées (UDF)

Le Administration informatique doit mettre à niveau vers une version antérieure toutes les applications WebView2 qui partagent le même dossier de données utilisateur (UDF) pour utiliser la même version du runtime WebView2.

Les applications WebView2 peuvent partager un dossier de données utilisateur (UDF) WebView2 pour réutiliser l’état du navigateur. Très peu d’applications partagent un dossier de données utilisateur (UDF) ; les seules applications connues qui partagent une FDU sont les applications de la suite Office : Excel, Word et PowerPoint.

L’accès à la même FDU à partir de différentes versions de WebView2 Runtime n’est pas sécurisé. Si l’application A WebView2 est rétrogradée et que l’application WebView2 B partage la même FDU mais n’est pas rétrogradée, l’application WebView2 A et l’application WebView2 B échouent rapidement au lancement.

Risques liés à la rétrogradation du runtime WebView2

Risques de sécurité

le risque Description
Vulnérabilités réintroduites La rétrogradation réintroduit les vulnérabilités corrigées qui ont été corrigées dans les versions plus récentes.
Affaiblissement de la conformité Les versions antérieures peuvent enfreindre la conformité dans les environnements réglementés.
Surface d’attaque étendue La gestion de plusieurs versions rétrogradées augmente la persistance de clients obsolètes.

Risques liés à l’intégrité des données

le risque Description
Altération du stockage Le passage à une version antérieure peut entraîner une corruption ou une incompatibilité si les formats de stockage, les schémas ou les API ont changé entre les versions (cookies, IndexedDB, stockage local).
Incompatibilités de schéma Contrairement au navigateur Edge qui utilise des instantanés de données utilisateur, WebView2 n’implémente pas de instantanés au niveau de la plateforme.
Perte de données utilisateur Instabilité du profil et perte potentielle de données si les formats de stockage ne sont pas compatibles.

Risques de compatibilité des applications

le risque Description
Ruptures de dépendance de fonctionnalité Une application WebView2 qui utilise des API ou des comportements WebView2 plus récents peut échouer ou se comporter de manière imprévisible après la rétrogradation du runtime WebView2.
Régressions de performances Les anciennes versions du runtime WebView2 peuvent entraîner des chargements de page plus lents, une utilisation plus élevée de la mémoire et des expériences dégradées.
Dysfonctionnement de l’application La rétrogradation du runtime WebView2 peut entraîner un dysfonctionnement d’une application WebView2, en raison de la dépendance à l’égard de fonctionnalités ou de modifications de rendu récemment introduites.

Risques opérationnels

le risque Description
Fragmentation de version La prise en charge du passage à une version antérieure au niveau de l’application peut entraîner une dérive de version entre les applications sur le même appareil.
Sédimentation Plusieurs anciennes versions s’accumulent sur les appareils au fil du temps, ce qui augmente la complexité.
Augmentation de l’utilisation du disque Une version supplémentaire de WebView2 Runtime est installée côte à côte avec la version actuelle d’Evergreen WebView2 Runtime, ce qui consomme de l’espace disque supplémentaire sur chaque périphérique.
Complexité de la coordination La rétrogradation nécessite une coordination minutieuse entre le Administration informatique, le propriétaire de l’application WebView2 et l’équipe de la plateforme.

Test et dépannage du déclassement de la rétrogradation du runtime

Vérification de l’application de la rétrogradation de Runtime

Après avoir défini la stratégie de rétrogradation WebView2 Runtime et redémarré l’application WebView2 cible, procédez comme suit.

1. Vérifiez le dossier versionné

  1. Dans l’Explorateur de fichiers, accédez à :C:\Program Files (x86)\Microsoft\EdgeWebView\Application\

  2. Vérifiez qu’un nouveau dossier apparaît, correspondant à la version rétrogradée (par 150.0.2178.0exemple).

    La présence de ce dossier versionné indique que le programme de mise à jour Edge a récupéré et mis en attente le runtime WebView2 rétrogradé.

2. Vérifier la stratégie du Registre

  1. Vérifiez que la DowngradeVersion clé est définie, sous : HKLM\Software\Policies\Microsoft\Edge\WebView2\DowngradeVersion

  2. Vérifiez que les entrées correspondent à la → TargetVersionconfigurée AppId .

3. Vérifiez la BrowserExecutableFolder redirection
  • La BrowserExecutableFolder stratégie doit être définie automatiquement pour pointer l’application vers le chemin d’accès Runtime rétrogradé.

Déclenchement d’une mise à jour forcée

Après avoir défini la DowngradeVersion stratégie, le programme de mise à jour Edge doit télécharger la version cible. Par défaut, cela se produit dans un délai d’environ 1 heure (aligné sur la cadence de tâche de mise à jour Edge/WebView2).

Pour déclencher une mise à jour immédiate :

  1. Ouvrez PowerShell en tant qu’administrateur.

  2. Recherchez la tâche de mise à jour Edge :

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

  3. Exécutez la tâche :

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

  4. Patientez quelques minutes pour que le téléchargement soit terminé.

  5. Redémarrez l’application WebView2.

Outils de diagnostic pour un dépannage plus approfondi

Les outils suivants sont utilisés pour résoudre les problèmes . Ils ne sont pas nécessaires pour la vérification standard :

Outil Objectif
edge://webview2-internals Afficher les processus WebView2 actifs, version d’exécution en cours d’utilisation.
Suivi ETW Capturez des journaux de diagnostic de bas niveau pour les événements de mise à jour/rétrogradation.
Observateur d’événements Recherchez dans les journaux des applications les erreurs de mise à jour WebView2 ou les échecs d’application de la politique.

Problèmes courants et résolution

Symptôme Cause probable Résolution
Application toujours en cours d’exécution sur la dernière version Application non redémarrée. Redémarrez l’application WebView2 (pas l’ordinateur).
Le dossier rétrogradé n’apparaît pas La version est en dehors de la plage « N-1 ou N-2 ». Vérifiez que la version cible se situe dans les deux versions précédentes les plus récentes.
L’application échoue rapidement au lancement (toutes les applications partageant un dossier de données utilisateur (UDF)). Incompatibilité de version de la FDU partagée. Passer à une version antérieure toutes les applications qui utilisent la même FDU vers la même version.
Stratégie non prise en compte. Chemin d’accès à la clé ou format de valeur incorrect. Vérifiez le chemin d’accès HKEY_LOCAL_MACHINE (HKLM), le format de nom de valeur (AUMID ou .exe) et le format numérique en quatre parties (par exemple, 151.0.2178.0).
Plusieurs applications sont touchées de manière inattendue. Dossier de données utilisateur partagées Identifiez le partage du dossier de données utilisateur (UDF) et assurez-vous que toutes les applications concernées sont alignées.
Le retour à une version antérieure a été rétabli automatiquement de manière inattendue. La version épinglée se trouvait en dehors de la plage prise en charge Il est attendu que la rétrogradation du runtime WebView2 expire une fois que la version du runtime ne se trouve plus dans la version N-1 ou N-2 (les deux versions antérieures du runtime).

Suppression de la rétrogradation du runtime WebView2

Important : Ne supprimez pas directement les clés de Registre. Toujours utiliser la stratégie de groupe (GPO) pour désactiver la stratégie, garantir une suppression nette et propre et éviter les configurations orphelines.

Si l’objet GPO a été utilisé pour configurer le passage à une version antérieure :

  1. Ouvrez l’éditeur de stratégie de groupe (gpedit.msc).

  2. Accédez à : Configuration > ordinateur Modèles > d’administration Microsoft Edge WebView2

  3. Définissez « Configurer la version de mise à niveau de WebView2 par application » sur Désactivé ou Non configuré.

  4. Redémarrez l’application WebView2.

    L’application reviendra à la dernière version d’Evergreen Runtime lors du prochain lancement.

Option 2 : Supprimer la stratégie par le biais du Registre

Attention : la manipulation directe du Registre ne doit être utilisée que si la stratégie d’origine a été définie via l’Éditeur du Registre. Si la stratégie de groupe (GPO) a été utilisée, rétablissez toujours l’utilisation de GPO, pour garantir la cohérence.

Si la stratégie a été initialement définie directement via le Registre (non recommandé en production) :

  1. Ouvrir regedit en tant qu’administrateur.

  2. Accédez à : HKEY_LOCAL_MACHINE\Software\Policies\Microsoft\Edge\WebView2\DowngradeVersion

  3. Supprimez la valeur spécifique (par exemplems-teams.exe).

  4. Redémarrez l’application WebView2.

Option 3 : Expiration automatique

La version antérieure expire automatiquement lorsque la version épinglée ne fait plus partie des deux versions précédentes les plus récentes :

  • Déclencheur : Deux nouvelles versions Evergreen ultérieures sont publiées au-delà de la version épinglée.

  • Comportement : Le programme de mise à jour Edge rétablit automatiquement les applications applicables au dernier Runtime.

  • Action d’Administration requise : supprimez la stratégie obsolète une fois qu’elle expire automatiquement.

  • Exemple : Si vous passez à la version antérieure 145 alors que la version 147 est en cours (145 est N-2), puis que la version 148 est publiée, la version 145 a maintenant trois versions de retard → la rétrogradation expire automatiquement.

Comportement post-annulation

Action Que se passe-t-il ?
Redémarrage de l’application L’application WebView2 récupère le dernier runtime WebView2 lors du prochain lancement de l’application.
BrowserExecutableFolder Suppression automatique ; l’application WebView2 revient à l’utilisation du chemin d’accès par défaut du runtime WebView2.
Bits d’exécution rétrogradés Nettoyé par le programme de mise à jour Edge à une cadence planifiée.
Données utilisateur Reste en place ; Aucune migration automatique des données n’a lieu.

Escalade et contact avec l’équipe WebView2

Chemin d’escalade :

  1. L’Administration d’entreprise contacte Microsoft CSS.

  2. CSS résolve le problème à l’aide de cet article.

  3. S’il n’est pas résolu, CSS transmet le problème à l’équipe ICM de la plateforme WebView2.

    Chemin de la zone : Edge\Web Experience\WebView2\Distribution

    Propriétaire du service : Incidents client du navigateur Edge.

    Propriétaire de l’équipe : Edge WebView2.

Voir aussi :

Voir également

Externe :

  • Last updated on