Cambiar a una versión anterior el tiempo de ejecución de WebView2

Si una nueva versión del tiempo de ejecución de WebView2 introduce una regresión crítica en una aplicación WebView2 específica, un Administración de TI puede cambiar el tiempo de ejecución de WebView2 de esa aplicación a una versión anterior, mediante la DowngradeVersion directiva, como solución temporal.

Contenido detallado:

Información general sobre la degradación de la empresa

En una empresa, el Administración de TI puede cambiar el tiempo de ejecución de WebView2 a una versión anterior, como medida temporal, mediante la DowngradeVersion directiva. Al usar el tiempo de ejecución Evergreen, si una nueva versión del entorno de ejecución introduce una regresión crítica, es probable que cada aplicación WebView2 y cada componente de Windows que usa el tiempo de ejecución WebView2 se vean afectados. Enterprise Downgrade ofrece un enfoque de mitigación a corto plazo para que el Administración de TI restaure la productividad afectada.

La DowngradeVersion directiva es una funcionalidad controlada de versión anterior que permite a un Administración de TI de empresa revertir temporalmente una aplicación WebView2 específica (aplicación WebView2) para usar una versión anterior del tiempo de ejecución de WebView2 a través de la directiva de grupo cuando una regresión crítica interrumpe las operaciones empresariales. Vea DowngradeVersion en Microsoft Edge WebView2: directivas.

El modelo de distribución Evergreen significa que el tiempo de ejecución de WebView2 se actualiza automáticamente junto con Microsoft Edge, de modo que la aplicación WebView2 siempre se ejecuta en la última versión del tiempo de ejecución de WebView2, sin intervención manual. El tiempo de ejecución Evergreen WebView2 garantiza que la aplicación WebView2 obtenga automáticamente revisiones de seguridad y mejoras de características. El Administración de TI de la empresa no puede desinstalar la actualización de tiempo de ejecución de WebView2 que afecta.

WebView2 es un control de explorador que permite a las aplicaciones de Windows (como Microsoft Teams, Outlook y software empresarial de terceros) insertar contenido web mediante el motor de representación de Microsoft Edge.

Cómo funciona la degradación de la empresa

  1. El Administración de TI identifica que una nueva versión del entorno de ejecución de WebView2 ha roto una aplicación WebView2 específica.

  2. El Administrador de TI establece una directiva de grupo que especifica que, para esta aplicación WebView2, se debe usar una versión anterior específica del tiempo de ejecución WebView2 en lugar del tiempo de ejecución WebView2 más reciente.

    Solo se admite la versión del entorno de ejecución WebView2 N-1 o N-2 relativa a la versión actual del entorno de ejecución WebView2. Se rechaza la degradación a una versión del tiempo de ejecución WebView2 anterior a la versión N-2.

  3. Edge Update descarga e instala la versión anterior del entorno de ejecución WebView2 en paralelo con el entorno de ejecución WebView2 actual.

  4. El cargador de WebView2 redirige solo la aplicación WebView2 de destino al tiempo de ejecución de WebView2 anterior.

  5. Todas las demás aplicaciones WebView2 del dispositivo siguen usando la última versión del tiempo de ejecución de WebView2; no se ven afectados por la rebaja.

  6. La degradación expira automáticamente después de que la versión anclada ya no esté dentro de las dos versiones anteriores más recientes del tiempo de ejecución WebView2.

Por qué existe la degradación de la empresa

Enterprise Downgrade es una herramienta de recuperación de último recurso. El cambio a una versión anterior de la empresa está dirigida, limitada en el tiempo y administrada por el Administración de TI de la empresa en asociación con los propietarios de la aplicación WebView2. Enterprise Downgrade no es un mecanismo de fijación de versiones.

La degradación de empresa proporciona una degradación temporal de la versión controlada por el Administrador para la aplicación WebView2 específica que se ve afectada, mientras el equipo de la plataforma prepara una corrección adecuada. Enterprise Downgrade solo debe usarse como medida de recuperación de último recurso, cuando una regresión crítica está interrumpiendo activamente las operaciones empresariales y ninguna otra mitigación (como una revisión, una marca de característica o una pausa de actualización) puede resolver el problema de manera oportuna. La degradación gana tiempo para que el equipo de la plataforma envíe una solución adecuada; La degradación no sustituye el envío de una solución adecuada.

En entornos empresariales críticos, las regresiones inesperadas en el tiempo de ejecución de WebView2 pueden detener los flujos de trabajo empresariales sin solución inmediata. Incluso las interrupciones breves resultan en pérdida de ingresos, SLA perdidos y mayores costos operativos. Los entornos empresariales de misión crítica incluyen, por ejemplo:

  • Sistemas sanitarios
  • Plataformas de trading financiero
  • Punto de venta minorista
  • Servicios gubernamentales

Aplicaciones WebView2 aplicables

La degradación empresarial del tiempo de ejecución de WebView2 no afecta automáticamente a ninguna aplicación WebView2. El Administración de TI debe configurar explícitamente la DowngradeVersion directiva para una aplicación WebView2 específica. Entonces, la directiva solo se aplicará a esa aplicación WebView2 específica.

Se pueden segmentar los siguientes tipos de aplicaciones WebView2:

  • Cualquier aplicación WebView2 Evergreen-Runtime que se ejecute en dispositivos Windows administrados por la empresa.

    • El Administrador de TI especifica el destino mediante:

      • El id. de modelo de usuario de la aplicación (AUMID), para aplicaciones empaquetadas o MSIX.
      • El nombre del archivo ejecutable (por ms-teams.exeejemplo, ).

    • Si existen entradas AUMID y .exe de nombre para la misma aplicación WebView2, la entrada AUMID tendrá prioridad.

Para buscar el .exe nombre:

  1. Abra el Administrador de tareas y, a continuación, seleccione Detalles, a la izquierda.

  2. Buscar la aplicación WebView2 en ejecución.

  3. Examine la columna Nombre de la aplicación WebView2, como ms-teams.exe o olk.exe.

Los siguientes tipos de aplicaciones WebView2 no se ven afectados por la DowngradeVersion directiva:

  • Aplicaciones WebView2 que no se especifican en la DowngradeVersion directiva.

    • Estas aplicaciones siguen usando el último tiempo de ejecución Evergreen de WebView2.

  • Aplicaciones WebView2 en dispositivos de consumidor o dispositivos no administrados.

  • Aplicaciones WebView2 que usan un tiempo de ejecución de WebView2 incluido en la aplicación (versión no editable).

Configuración y prioridad de directivas

HKEY_CURRENT_USER (HKCU) no es compatible; Se trata de una directiva empresarial de nivel de equipo únicamente (HKEY_LOCAL_MACHINE (HKLM)).

Ubicación Ruta de acceso
Directiva de grupo (recomendado) Configuración del> equipoPlantillas> administrativasMicrosoft Edge WebView2>Configurar la versión de degradación de WebView2 por aplicación
Registro HKLM\Software\Policies\Microsoft\Edge\WebView2\DowngradeVersion

Prioridad cuando existen varias directivas (de mayor a menor):

  1. directiva DowngradeVersion — siempre gana.

  2. BrowserExecutableFolder: si lo establece de forma independiente el Administrador de TI.

  3. Tiempo de ejecución de Evergreen predeterminado : el más bajo.

Si ambos DowngradeVersion y BrowserExecutableFolder están configurados de forma independiente, DowngradeVersion tiene prioridad e invalida la BrowserExecutableFolder redirección.

Principios básicos de diseño

  • Controladas por el Administrador de TI de la empresa: solo los administradores de TI pueden iniciar una degradación a través de la directiva de grupo. Los desarrolladores y los usuarios finales no pueden activarlo.

  • Cumplimiento del servicio de actualización: Edge Update descarga la versión necesaria si es necesario y continúa con las actualizaciones normales de todas las demás aplicaciones.

  • Caducidad automática: Una versión degradada sigue siendo válida solo mientras esté dentro de las dos versiones anteriores más recientes (N-1 o N-2). Una vez que se publiquen dos nuevas versiones principales posteriores más allá de la versión degradada, la degradación expira y la aplicación se revierte automáticamente al último tiempo de ejecución. Microsoft recomienda que la Administración de TI quite la directiva obsoleta después de que expire automáticamente.

  • Segmentación por aplicación: La degradación se aplica por aplicación, no por todo el dispositivo. Cada aplicación WebView2 debe especificarse individualmente en la directiva.

Degradar temporalmente el tiempo de ejecución de WebView2

Actualización de la plantilla de directiva

Para actualizar la plantilla de directiva:

  1. Vaya a Descargar e implementar Microsoft Edge para negocios.

  2. En la sección Descargar lo último , haz clic en uno de los siguientes botones:

    • Windows
    • macOS
    • Linux

  3. Haga clic en Descargar ... Vínculo de directiva , como:

    • Descargar directiva de Windows de 64 bits
    • Descargar la directiva de Windows de 32 bits
    • Descargar Windows ARM64 Policy
    • Descargar directiva universal de macOS
    • Descargar directiva de Linux (.rpm)
    • Directiva de descarga Linux (.deb)

    Se abre el cuadro de diálogo Descargar archivo de directiva de Microsoft Edge .

  4. Haga clic en el botón Aceptar y descargar .

    Se descarga un archivo, como MicrosoftEdgePolicyTemplates.cab.

  5. En Microsoft Edge, seleccione Configuración y más (...), seleccione Descargas y, a continuación, para el archivo descargado, haga clic en Abrir carpeta contenedora.

    En Windows, se abre el Explorador de archivos con el archivo MicrosoftEdgePolicyTemplates.cab seleccionado.

  6. Haga clic con el botón derecho y, a MicrosoftEdgePolicyTemplates.cabcontinuación, seleccione Abrir.

    MicrosoftEdgePolicyTemplates.zip aparece.

  7. Haga clic con el botón derecho y MicrosoftEdgePolicyTemplates.zip, a continuación, seleccione Extraer.

    Se abrirá el cuadro de diálogo Seleccionar un destino .

  8. Seleccione el directorio, como C:\Users\local-account\Downloads, y, a continuación, haga clic en el botón Extraer .

    Se crea una carpeta como: C:\Users\local-account\Downloads\MicrosoftEdgePolicyTemplates.zip

  9. En la izquierda, seleccione MicrosoftEdgePolicyTemplates.zipy, a continuación, abra el /windows/ directorio a la derecha.

    Las carpetas /adm/ y /admx/ se enumeran.

  10. Copie las carpetas /adm/ y /admx/ en un /PolicyDefinitions/ directorio. Por ejemplo, para Windows, copie las /adm/ carpetas and /admx/ en C:\Windows\PolicyDefinitions\.

    Se abrirá el cuadro de diálogo de denegación de acceso a la carpeta de destino en el que se indica "Deberá proporcionar permiso de administrador para copiar a esta carpeta".

  11. Haga clic en el botón Continuar .

    Se abre el cuadro de diálogo Control de cuentas de usuario .

  12. Escriba las credenciales de administrador.

Opción 1: Directiva de grupo (GPO)

Este es el enfoque recomendado para entornos empresariales. La directiva de grupo garantiza una administración centralizada y auditable en todos los dispositivos administrados.

  1. Abra el Editor de directivas de grupo (gpedit.msc).

  2. Vaya a: Configuración del > equipo Plantillas > administrativas Microsoft Edge WebView2

  3. Buscar Configurar la versión anterior de WebView2 por aplicación.

  4. Habilite la directiva y escriba la siguiente información:

    • Nombre: El identificador de aplicación (AUMID). O bien, el .exe nombre, como ms-teams.exe.

    • Valor: El número de versión de cuatro partes de destino (como 151.0.2178.0).

Opción 2: Editor del Registro (regedit)

Para la configuración de destino en máquinas individuales. Requiere privilegios de administrador local.

  1. Abrir regedit como administrador.

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

  3. Cree una nueva clave cuyo nombre se llame DowngradeVersion (si no existe).

  4. Dentro de la DowngradeVersion clave, cree un nuevo String Value (REG_SZ):

    • Nombre del valor: El nombre AUMID o ejecutable (por ejemplo ms-teams.exe, ).

    • Información del valor: Número de la versión principal de destino.

      • Establezca el valor en la cadena de versión completa de destino con el formato numérico de cuatro partes (por ejemplo, 151.0.2178.0).

      • El Administración de TI puede encontrar el número exacto de la versión de cuatro partes en las notas de la versión de Microsoft Edge para el canal estable.

      • Valores de ejemplo:

        • Nombre: ms-teams.exe, Valor: 151.0.2178.0
        • Nombre: olk.exe, Valor: 152.0.2164.0

  5. Reinicia la aplicación WebView2 para que la directiva surta efecto.

Por ejemplo:

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

Notas importantes

  • Solo HKEY_LOCAL_MACHINE se admite HKEY_CURRENT_USER (HKLM); (HKCU) se omite.

  • No se admiten los valores siguientes:

    • Valores exclusivos de una especialización (por ejemplo, 151).
    • Valores comodín (por ejemplo, 151.*).
    • Valores que no son exactos Versiones numéricas de cuatro componentes.

  • El cargador WebView2 resuelve el directorio de instalación en tiempo de ejecución solo cuando existe una carpeta que coincide exactamente con la versión completa configurada. Por ejemplo, 151.0.2178.0 debe coincidir exactamente con 151.0.2178.0.

    Si no se encuentra ninguna carpeta exacta, la directiva no tiene ningún efecto y el tiempo de ejecución se establece de forma predeterminada en la BrowserExecutableFolder directiva o en el tiempo de ejecución Evergreen (el tiempo de ejecución de actualización automática predeterminado).

  • Edge Update descargará automáticamente la versión necesaria si cumple las condiciones N-1 o N-2. El Administrador de TI no necesita preconfigurar las carpetas de versión en el disco.

  • No es necesario reiniciar el equipo, pero la aplicación WebView2 debe reiniciarse y la degradación puede tardar hasta una hora en surtir efecto.

  • Latencia de directiva para la aplicación WebView2: los cambios surten efecto en el plazo de una hora desde la implementación. Esto está alineado con la cadencia de tareas de actualización de Microsoft Edge y WebView2. Para activar una actualización forzada, consulta Activar una actualización forzada, a continuación.

  • La aplicación de directivas de cambio a una versión anterior en tiempo de ejecución invalida lo siguiente:

    • Ventanas de mantenimiento.
    • Intervalos de actualización extendidos.
    • Marcas de tiempo de última comprobación almacenadas en caché.

Flujo del proceso: cómo se implementa la degradación

  1. El Administración de TI establece la directiva mediante la directiva de grupo, especificando el AppId y TargetVersion.

  2. El actualizador de Edge lee la directiva y valida que TargetVersion esté dentro de N-1 o N-2.

  3. Edge Update descarga la versión degradada del tiempo de ejecución de WebView2, si es necesario, como una instalación en paralelo.

  4. El actualizador de Edge establece BrowserExecutableFolder una directiva para la aplicación de destino a fin de redirigirla a la versión especificada del tiempo de ejecución WebView2.

  5. Edge Update mantiene la asignación siempre y cuando la versión degradada del tiempo de ejecución WebView2 se mantenga dentro del intervalo admitido.

  6. Cuando la versión anclada del tiempo de ejecución WebView2 queda fuera del intervalo admitido, o se quita la directiva, Edge Update limpia y revierte la aplicación WebView2 al uso de la última versión del tiempo de ejecución WebView2.

Si una directiva de cambio a una versión anterior del tiempo de ejecución WebView2 está activa, pero la versión del entorno de ejecución WebView2 de destino aún no se ha descargado (por ejemplo, debido a restricciones de red o disco), la aplicación WebView2 seguirá usando el último tiempo de ejecución de WebView2, hasta que el entorno de ejecución WebView2 anterior esté presente. La aplicación WebView2 no dejará de iniciarse únicamente porque la versión degradada del tiempo de ejecución WebView2 esté pendiente de descarga.

Limitaciones de degradar el tiempo de ejecución de WebView2

Limitaciones de versión

Limitación Detalle
Intervalo de versiones Solo se admite la versión N-1 o N-2 del tiempo de ejecución WebView2 relativa a la versión actual del tiempo de ejecución Evergreen. Se rechaza la degradación a un entorno en tiempo de ejecución WebView2 anterior a las dos versiones anteriores.
Formato de versión Solo los números de versión principales (solo dígitos). Las cadenas, los puntos o los caracteres comodín de la versión completa no son válidos.
Caducidad automática Una versión degradada del tiempo de ejecución WebView2 solo permanece activa mientras está dentro de las dos versiones anteriores más recientes. Después de dos nuevas versiones posteriores de la versión en tiempo de ejecución más allá de la versión anclada, la degradación expira automáticamente y la aplicación vuelve al último tiempo de ejecución WebView2.
Disponibilidad La característica de cambio a una versión anterior solo está disponible para Microsoft Edge WebView2 versión 150 o posterior.

Limitaciones de ámbito

Limitación Detalle
Solo para empresas No se admite en dispositivos de consumidor o no administrados.
Solo a nivel de equipo La directiva solo se puede establecer en el nivel de la máquina local (HKEY_LOCAL_MACHINE (HKLM)). No se admite la configuración de la política de degradación para el usuario actual (HKEY_CURRENT_USER (HKCU)); No hay ninguna directiva de nivel de usuario ni control de nivel de usuario individual.
Segmentación por aplicación No se puede realizar una degradación en toda la empresa en todas las aplicaciones WebView2. Cada aplicación WebView2 debe tener una segmentación individual.
Sin control de desarrollador Solo un Administrador de TI puede iniciar la degradación del tiempo de ejecución de WebView2. Un desarrollador no puede desencadenar una degradación del tiempo de ejecución de WebView2, como a través de una API.
Sin anclaje indefinido La solución NO admite la fijación de versiones permanentes o a largo plazo.

Restricciones de la carpeta de datos de usuario compartida (UDF)

El Administrador de TI debe cambiar a una versión anterior todas las aplicaciones WebView2 que comparten la misma carpeta de datos de usuario (UDF) para usar la misma versión del entorno de ejecución WebView2.

Las aplicaciones WebView2 pueden compartir una carpeta de datos de usuario (UDF) WebView2 para reutilizar el estado del explorador. Muy pocas aplicaciones comparten una carpeta de datos de usuario (UDF); las únicas aplicaciones conocidas que comparten una UDF son las aplicaciones del conjunto de aplicaciones de Office: Excel, Word y PowerPoint.

No es seguro acceder a la misma UDF desde diferentes versiones del entorno de ejecución WebView2. Si se degrada la versión A de la aplicación WebView2 y la aplicación B de WebView2 comparte la misma UDF pero no se degrada, se producirá un error rápido en el inicio de la aplicación A de WebView2 y de la aplicación B de WebView2.

Riesgos de degradar el tiempo de ejecución de WebView2

Riesgos de seguridad

de riesgos Descripción
Vulnerabilidades reintroducidas La degradación vuelve a introducir vulnerabilidades parcheadas que se han corregido en versiones más recientes.
Debilitamiento del cumplimiento Las versiones anteriores pueden infringir el cumplimiento en entornos regulados.
Superficie de ataque ampliada La administración de varias versiones degradadas aumenta la persistencia de los clientes obsoletos.

Riesgos de integridad de datos

de riesgos Descripción
Daños en el almacenamiento El retroceso puede causar daños o incompatibilidad si los formatos de almacenamiento, esquemas o API han cambiado entre versiones (cookies, IndexedDB, almacenamiento local).
Errores de coincidencia del esquema A diferencia del explorador Microsoft Edge, que usa instantáneas de datos de usuario, WebView2 no implementa la creación de instantáneas de nivel de plataforma.
Pérdida de datos de usuario Inestabilidad del perfil y posible pérdida de datos si los formatos de almacenamiento son incompatibles.

Riesgos de compatibilidad de aplicaciones

de riesgos Descripción
Saltos de dependencia de características Una aplicación WebView2 que usa las API o comportamientos de WebView2 más recientes puede producir un error o comportarse de manera impredecible después de degradar el tiempo de ejecución de WebView2.
Regresiones de rendimiento Las versiones anteriores del tiempo de ejecución de WebView2 pueden introducir cargas de página más lentas, un mayor uso de memoria y experiencias degradadas.
Mal funcionamiento de la aplicación Degradar el tiempo de ejecución de WebView2 puede provocar un mal funcionamiento de una aplicación WebView2, debido a la dependencia de características introducidas recientemente o cambios de representación.

Riesgos operativos

de riesgos Descripción
Fragmentación de la versión Admitir una versión anterior en el nivel de aplicación puede provocar un desfase de versión entre las aplicaciones del mismo dispositivo.
Sedimentación Varias versiones anteriores se acumulan en los dispositivos con el tiempo, lo que aumenta la complejidad.
Mayor uso del disco Una versión adicional del entorno de ejecución WebView2 se instala en paralelo con la versión actual del entorno de ejecución Evergreen WebView2, lo que consume espacio adicional en disco en cada dispositivo.
Complejidad de la coordinación La degradación requiere una coordinación cuidadosa entre el Administración de TI, el propietario de la aplicación WebView2 y el equipo de plataforma.

Pruebas y solución de problemas de degradación del tiempo de ejecución

Verificar que se aplicó la degradación del tiempo de ejecución

Después de establecer la directiva de reducción del tiempo de ejecución de WebView2 y reiniciar la aplicación WebView2 de destino, haz lo siguiente.

1. Compruebe la carpeta versionada

  1. En el Explorador de archivos, vaya a:C:\Program Files (x86)\Microsoft\EdgeWebView\Application\

  2. Confirme que aparece una nueva carpeta que coincide con la versión degradada (por ejemplo 150.0.2178.0).

    La presencia de esta carpeta versionada indica que Edge Update ha capturado y preconfigurado el tiempo de ejecución WebView2 degradado.

2. Comprobar la directiva del Registro

  1. Confirme que la DowngradeVersion clave está establecida, en: HKLM\Software\Policies\Microsoft\Edge\WebView2\DowngradeVersion

  2. Compruebe que las entradas coinciden con los → TargetVersionconfigurados AppId .

3. Comprobar la BrowserExecutableFolder redirección
  • La BrowserExecutableFolder directiva debe establecerse automáticamente para que apunte la aplicación a la ruta de acceso del entorno de ejecución degradada.

Desencadenar una actualización forzada

Después de establecer la DowngradeVersion directiva, Edge Update debe descargar la versión de destino. De forma predeterminada, esto sucede en un plazo aproximado de 1 hora (alineado con la cadencia de la tarea de actualización de Edge/WebView2).

Para desencadenar una actualización inmediata:

  1. Abra PowerShell como administrador.

  2. Busque la tarea de actualización de Edge:

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

  3. Ejecute la tarea:

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

  4. Espere unos minutos a que se complete la descarga.

  5. Reinicia la aplicación WebView2.

Herramientas de diagnóstico para una solución de problemas más profunda

Las siguientes herramientas son para solucionar problemas , pero no son necesarias para la verificación estándar:

Herramienta Propósito
edge://webview2-internals Ver procesos WebView2 activos, versión del entorno de ejecución en uso.
Seguimiento ETW Captura registros de diagnóstico de bajo nivel para eventos de actualización o degradación.
Visor de eventos Compruebe los registros de aplicaciones para ver si hay errores de actualización de WebView2 o errores de aplicación de directivas.

Problemas comunes y resolución

Síntoma Causa probable Resolución
La aplicación sigue ejecutándose en la versión más reciente La aplicación no se ha reiniciado. Reinicie la aplicación WebView2 (no la máquina).
La carpeta degradada no aparece La versión está fuera del rango "N-1 o N-2". Compruebe que la versión de destino se encuentra dentro de las dos versiones anteriores más recientes.
La aplicación falla rápidamente al iniciarse (todas las aplicaciones comparten una carpeta de datos de usuario (UDF)). Error de coincidencia de la versión de UDF compartida. Cambiar a una versión anterior todas las aplicaciones que usan la misma UDF.
La directiva no surte efecto. Formato incorrecto de ruta de acceso o valor de clave. Compruebe la ruta de acceso HKEY_LOCAL_MACHINE (HKLM), el formato del nombre de valor (AUMID o .exe) y el formato numérico de cuatro partes (como 151.0.2178.0).
Varias aplicaciones se ven afectadas de forma inesperada. Carpeta de datos de usuario compartida Identifique el uso compartido de carpetas de datos de usuario (UDF) y asegúrese de que todas las aplicaciones afectadas estén alineadas.
La degradación se revirtió automáticamente inesperadamente. La versión anclada quedó fuera del rango admitido Se espera que la degradación del tiempo de ejecución WebView2 expire después de que la versión del tiempo de ejecución ya no esté dentro de la versión N-1 o N-2 (las dos versiones anteriores del tiempo de ejecución).

Quitar la degradación del tiempo de ejecución de WebView2

Importante: No elimines las claves del Registro directamente. Utilice siempre la directiva de grupo (GPO) para deshabilitar la directiva, garantizar una eliminación limpia y evitar una configuración huérfana.

Si se usó GPO para configurar la degradación a una versión anterior:

  1. Abra el Editor de directivas de grupo (gpedit.msc).

  2. Vaya a: Configuración del > equipo Plantillas > administrativas Microsoft Edge WebView2

  3. Establezca "Configurar la versión de degradación de WebView2 por aplicación" en Deshabilitado o No configurado.

  4. Reinicia la aplicación WebView2.

    La aplicación se revertirá al último entorno de ejecución Evergreen en el próximo lanzamiento.

Opción 2: Quitar la directiva a través del Registro

Precaución: La manipulación directa del Registro solo debe usarse si la directiva original se estableció mediante el Editor del Registro. Si se usó la directiva de grupo (GPO), revierta siempre mediante GPO para garantizar la coherencia.

Si la directiva se estableció originalmente directamente a través del Registro (no recomendado en producción):

  1. Abrir regedit como administrador.

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

  3. Elimine el valor específico (por ejemploms-teams.exe).

  4. Reinicia la aplicación WebView2.

Opción 3: expiración automática

La degradación expira automáticamente cuando la versión anclada ya no está dentro de las dos versiones anteriores más recientes:

  • Desencadenador: Se publican dos nuevas versiones posteriores de Evergreen más allá de la versión anclada.

  • Comportamiento: El actualizador de Edge revierte automáticamente las aplicaciones aplicables al último tiempo de ejecución.

  • Se requiere una acción del administrador: quitar la directiva obsoleta una vez que expire automáticamente.

  • Ejemplo: Si degrada a la versión 145 mientras que la 147 es actual (145 es N-2) y, a continuación, la versión 148, la versión 145 está ahora tres versiones por detrás → la degradación expira automáticamente.

Comportamiento posterior a la reversión

Acción Qué sucede
Reinicio de la aplicación La aplicación WebView2 recoge el último tiempo de ejecución de WebView2 durante el siguiente inicio de la aplicación.
BrowserExecutableFolder Eliminado automáticamente; la aplicación WebView2 vuelve a usar la ruta de acceso del tiempo de ejecución WebView2 predeterminada.
Bits de tiempo de ejecución degradados Limpiado por el actualizador de Edge en una cadencia programada.
Datos del usuario Permanece en su lugar; No se produce ninguna migración automática de datos.

Escalar y contactar con el equipo de WebView2

Ruta de escalación:

  1. El Administración de empresa se pone en contacto con Microsoft CSS.

  2. CSS soluciona el problema mediante este artículo.

  3. Si no se resuelve, CSS remite el problema al ICM del equipo de la plataforma WebView2.

    Area Path: Edge\Web Experience\WebView2\Distribution

    Propietario del servicio: Incidentes de clientes del explorador Edge.

    Equipo propietario: Edge WebView2.

Consulta también:

Consulte también

Externo:

  • Last updated on