Microsoft Edge WebView2: directivas

La versión más reciente de Microsoft Edge WebView2 incluye las siguientes directivas. Puede usar estas directivas para configurar cómo se ejecuta Microsoft Edge WebView2 en su organización.

Para obtener información sobre un conjunto adicional de directivas usadas para controlar cómo y cuándo se actualiza Microsoft Edge WebView2, vea la referencia de directiva de actualización de Microsoft Edge.

Nota

Este artículo es aplicable para Microsoft Edge, versión 87 o posterior.

Directivas disponibles

En estas tablas se muestran todas las directivas de grupo disponibles en esta versión de Microsoft Edge WebView2. Usa los vínculos de la tabla para obtener más detalles sobre directivas específicas.

Configuración de invalidación de Loader

Nombre de directiva Subtítulo
BrowserExecutableFolder Configure la ubicación de la carpeta ejecutable del explorador
ReleaseChannelPreference Establezca las preferencias de pedido de búsqueda de canal de publicación

Adicional

Nombre de directiva Subtítulo
ExperimentationAndConfigurationServiceControl Controlar la comunicación con el servicio de experimentación y configuración
ForcePermissionPolicyUnloadDefaultEnabled Controla si se pueden deshabilitar los controladores de eventos de descarga.
NewPDFReaderWebView2List Habilitación del lector de PDF integrado con tecnología de Adobe Acrobat para WebView2

Directivas de configuración de invalidación de Loader

Volver al principio

BrowserExecutableFolder

Configure la ubicación de la carpeta ejecutable del explorador

Versiones compatibles:

  • En Windows desde la versión 87 o posterior

Descripción

Esta directiva configura las aplicaciones de WebView2 para usar el tiempo de ejecución de WebView2 en la ruta de acceso especificada. La carpeta debe contener los siguientes archivos: msedgewebview2. exe, msedge. dll, etc.

Para establecer el valor de la ruta de acceso de la carpeta, especifique un par de valor y nombre de valor. Configure el nombre de valor en el ID. del modelo de usuario de la aplicación o en el nombre del archivo ejecutable. Puede usar el carácter comodín "*" como nombre de valor para aplicar a todas las aplicaciones.

Características admitidas:

  • Puede ser obligatorio: sí
  • Puede ser recomendable: no
  • Actualización de directiva dinámica: sí

Tipo de datos:

  • Lista de cadenas

Información y configuración de Windows

Información de directiva de grupo (ADMX)
  • Nombre único de GP: BrowserExecutableFolder
  • Nombre GP: configure la ubicación de la carpeta ejecutable del explorador.
  • Ruta de acceso de GP (obligatorio): Plantillas administrativas/Microsoft Edge WebView2/Loader cambiar configuración
  • Ruta de acceso de GP (recomendado): N/D
  • Nombre de archivo ADMX de GP: MSEdgeWebView2. ADMX
Configuración del Registro de Windows
  • Ruta (obligatoria): SOFTWARE\Policies\Microsoft\Edge\WebView2\BrowserExecutableFolder
  • Ruta de acceso (recomendado): N/D
  • Nombre del valor: lista de REG_SZ
  • Tipo de valor: lista de REG_SZ
Valor de ejemplo:
SOFTWARE\Policies\Microsoft\Edge\WebView2\BrowserExecutableFolder = "Name: *, Value: C:\\Program Files\\Microsoft Edge WebView2 Runtime Redistributable 85.0.541.0 x64"

Volver al principio

ReleaseChannelPreference

Establezca las preferencias de pedido de búsqueda de canal de publicación

Versiones compatibles:

  • En Windows desde la versión 87 o posterior

Descripción

El orden de búsqueda por canal predeterminado es WebView2 Runtime, Beta, Dev y Canarias.

Para invertir el orden de búsqueda predeterminado, establezca esta directiva en 1.

Para establecer el valor de las preferencias de canal de liberación, especifique un nombre de valor y un par de valores. Configure el nombre de valor en el ID. del modelo de usuario de la aplicación o en el nombre del archivo ejecutable. Puede usar el carácter comodín "*" como nombre de valor para aplicar a todas las aplicaciones.

Características admitidas:

  • Puede ser obligatorio: sí
  • Puede ser recomendable: no
  • Actualización de directiva dinámica: sí

Tipo de datos:

  • Lista de cadenas

Información y configuración de Windows

Información de directiva de grupo (ADMX)
  • Nombre único de GP: ReleaseChannelPreference
  • Nombre GP: establecer el canal de lanzamiento de preferencias de pedido de búsqueda
  • Ruta de acceso de GP (obligatorio): Plantillas administrativas/Microsoft Edge WebView2/Loader cambiar configuración
  • Ruta de acceso de GP (recomendado): N/D
  • Nombre de archivo ADMX de GP: MSEdgeWebView2. ADMX
Configuración del Registro de Windows
  • Ruta (obligatoria): SOFTWARE\Policies\Microsoft\Edge\WebView2\ReleaseChannelPreference
  • Ruta de acceso (recomendado): N/D
  • Nombre del valor: lista de REG_SZ
  • Tipo de valor: lista de REG_SZ
Valor de ejemplo:
SOFTWARE\Policies\Microsoft\Edge\WebView2\ReleaseChannelPreference = "Name: *, Value: 1"

Volver al principio

Otras directivas

Volver al principio

ExperimentationAndConfigurationServiceControl

Controlar la comunicación con el servicio de experimentación y configuración

Versiones compatibles:

  • En Windows desde la versión 97 o posterior

Descripción

El servicio de experimentación y configuración se usa para implementar cargas de experimentación y configuración en el cliente.

La carga útil de experimentación consiste en una lista de características de las primeras fases de desarrollo que Microsoft ha habilitado para realizar pruebas y obtener comentarios.

La carga de configuración consta de una lista de opciones recomendadas que Microsoft quiere implementar para optimizar la experiencia del usuario.

La carga de configuración también puede contener una lista de acciones que se deben realizar en determinados dominios por motivos de compatibilidad. Por ejemplo, el explorador puede invalidar la cadena del agente de usuario en un sitio web si ese sitio web está roto. Todas estas acciones están pensadas para ser temporales mientras Microsoft intenta resolver el problema con el propietario del sitio.

Si establece esta directiva en "FullMode", se descargará la carga útil completa del Servicio de experimentación y configuración. Esto incluye las cargas útiles de experimentación y configuración.

Si establece esta directiva en "ConfigurationsOnlyMode", solo se descargará la carga de configuración.

Si establece esta directiva en "RestrictedMode", la comunicación con el Servicio de experimentación y configuración se detendrá completamente. Microsoft no recomienda esta configuración.

Si no configura esta directiva en un dispositivo administrado, el comportamiento en los canales Beta y Estable es el mismo que el de "ConfigurationsOnlyMode". En los canales Canary y Dev, el comportamiento es el mismo que cuando se usa "FullMode".

Si no configura esta directiva en un dispositivo no administrado, el comportamiento es el mismo que cuando se usa "FullMode".

Asignación de opciones de directiva:

  • FullMode (2) = recuperar configuraciones y experimentos

  • ConfigurationsOnlyMode (1) = solo recuperar configuraciones

  • RestrictedMode (0) = deshabilitar la comunicación con el servicio de experimentación y configuración

Use la información anterior al configurar esta directiva.

Características admitidas:

  • Puede ser obligatorio: sí
  • Puede ser recomendable: no
  • Actualización de directiva dinámica: sí

Tipo de datos:

  • Integer

Información y configuración de Windows

Información de directiva de grupo (ADMX)
  • Nombre único de GP: ExperimentationAndConfigurationServiceControl
  • Nombre de GP: controlar la comunicación con el servicio de experimentación y configuración
  • Ruta de acceso de GP (obligatoria): Administrative Templates/Microsoft Edge WebView2/
  • Ruta de acceso de GP (recomendado): N/D
  • Nombre de archivo ADMX de GP: MSEdgeWebView2. ADMX
Configuración del Registro de Windows
  • Ruta de acceso (obligatoria): SOFTWARE\Policies\Microsoft\Edge\WebView2
  • Ruta de acceso (recomendado): N/D
  • Nombre del valor: ExperimentationAndConfigurationServiceControl
  • Tipo de valor: REG_DWORD
Valor de ejemplo:
0x00000002

Volver al principio

ForcePermissionPolicyUnloadDefaultEnabled

Controla si se pueden deshabilitar los controladores de eventos de descarga.

Versiones compatibles:

  • En Windows desde 118 o posterior

Descripción

los controladores de eventos unload están en desuso. Si se activan depende de la directiva permissions-policy de descarga. Actualmente, se permiten por directiva de forma predeterminada. En el futuro se pasarán gradualmente a ser no permitidos de forma predeterminada y los sitios deben habilitarlos explícitamente mediante encabezados de Permissions-Policy. Esta directiva empresarial se puede usar para excluirse de este desuso gradual al forzar que el valor predeterminado permanezca habilitado.

Las páginas pueden depender de controladores de eventos de descarga para guardar datos o indicar el final de una sesión de usuario al servidor. Esto no se recomienda porque no es confiable y afecta al rendimiento al bloquear el uso de BackForwardCache. Existen alternativas recomendadas, pero el evento unload se ha usado durante mucho tiempo. Es posible que algunas aplicaciones todavía dependan de ellas.

Si deshabilita esta directiva o no la configura, los controladores de eventos de descarga se dejarán de usar gradualmente en línea con el lanzamiento de desuso y los sitios que no establezcan Permissions-Policy encabezado dejarán de desencadenar unload eventos.

Si habilita esta directiva, los controladores de eventos de descarga seguirán funcionando de forma predeterminada.

Características admitidas:

  • Puede ser obligatorio: sí
  • Puede ser recomendable: no
  • Actualización de directiva dinámica: sí

Tipo de datos:

  • Booleano

Información y configuración de Windows

Información de directiva de grupo (ADMX)
  • Nombre único de GP: ForcePermissionPolicyUnloadDefaultEnabled
  • Nombre de GP: controla si se pueden deshabilitar los controladores de eventos de descarga.
  • Ruta de acceso de GP (obligatoria): Administrative Templates/Microsoft Edge WebView2/
  • Ruta de acceso de GP (recomendado): N/D
  • Nombre de archivo ADMX de GP: MSEdgeWebView2. ADMX
Configuración del Registro de Windows
  • Ruta de acceso (obligatoria): SOFTWARE\Policies\Microsoft\Edge\WebView2
  • Ruta de acceso (recomendado): N/D
  • Nombre del valor: ForcePermissionPolicyUnloadDefaultEnabled
  • Tipo de valor: REG_DWORD
Valor de ejemplo:
0x00000001

Volver al principio

NewPDFReaderWebView2List

Habilitación del lector de PDF integrado con tecnología de Adobe Acrobat para WebView2

Versiones compatibles:

  • En Windows desde 116 o posterior

Descripción

Esta directiva configura aplicaciones WebView2 para iniciar la nueva versión del lector de PDF con tecnología del lector de PDF de Adobe Acrobat. El nuevo lector de PDF garantiza que no se pierda la funcionalidad y ofrece una experiencia pdf mejorada. Esta experiencia incluye una representación más enriquecida, un rendimiento mejorado, una fuerte seguridad para el control de archivos PDF y una mayor accesibilidad.

Si se especifica esta directiva para una aplicación, es posible que también afecte a otras aplicaciones relacionadas. La directiva se aplica a todos los WebView2 que comparten la misma carpeta de datos de usuario de WebView2. Estos WebView2 podrían pertenecer a varias aplicaciones si esas aplicaciones, que probablemente pertenecen a la misma familia de productos, están diseñadas para compartir la misma carpeta de datos de usuario.

Use un par nombre-valor para habilitar el nuevo lector de PDF para la aplicación. Establezca el nombre en el identificador del modelo de usuario de la aplicación o el nombre de archivo ejecutable. Puede usar el carácter comodín "*" como nombre de valor para aplicar a todas las aplicaciones. Establezca value en true para habilitar el nuevo lector o establézcalo en false para usar el existente.

Si habilita esta directiva para las aplicaciones WebView2 especificadas, usarán el nuevo lector pdf con tecnología adobe Acrobat para abrir todos los archivos PDF.

Si deshabilita la directiva para las aplicaciones WebView2 especificadas o no la configura, usará el lector de PDF existente para abrir todos los archivos PDF.

Características admitidas:

  • Puede ser obligatorio: sí
  • Puede ser recomendable: no
  • Actualización de directiva dinámica: no es necesario reiniciar el explorador

Tipo de datos:

  • Lista de cadenas

Información y configuración de Windows

Información de directiva de grupo (ADMX)
  • Nombre único de GP: NewPDFReaderWebView2List
  • Nombre de GP: Habilitación del lector de PDF integrado con tecnología de Adobe Acrobat para WebView2
  • Ruta de acceso de GP (obligatoria): Administrative Templates/Microsoft Edge WebView2/
  • Ruta de acceso de GP (recomendado): N/D
  • Nombre de archivo ADMX de GP: MSEdgeWebView2. ADMX
Configuración del Registro de Windows
  • Ruta de acceso (obligatoria): SOFTWARE\Policies\Microsoft\Edge\WebView2\NewPDFReaderWebView2List
  • Ruta de acceso (recomendado): N/D
  • Nombre del valor: lista de REG_SZ
  • Tipo de valor: lista de REG_SZ
Valor de ejemplo:
SOFTWARE\Policies\Microsoft\Edge\WebView2\NewPDFReaderWebView2List = {"name": "app1.exe", "value": true}
SOFTWARE\Policies\Microsoft\Edge\WebView2\NewPDFReaderWebView2List = {"name": "app_id_for_app2", "value": true}
SOFTWARE\Policies\Microsoft\Edge\WebView2\NewPDFReaderWebView2List = {"name": "*", "value": false}

Volver al principio

Ver también