Conservación de la configuración personalizada de Exchange Server

SE APLICA A:NO-IMG-162016 yes-img-192019 yes-img-seEdición de suscripción

Información general

Después de instalar Exchange Server, una tarea administrativa común es personalizar la configuración, como los límites de tamaño de mensaje específicos del cliente. Estas opciones se suelen configurar en web.config, sharedweb.configy otros archivos de configuración en el servidor de Exchange.

Históricamente, uno de los desafíos para los administradores de servidores Exchange es que cada vez que se instala una actualización acumulativa (CU), estos archivos y su configuración personalizada se sobrescriben con la instalación, lo que obliga a un administrador a realizar una copia de seguridad / restaurar su configuración o volver a aplicarla después de cada instalación de CU.

Con Exchange Server 2019 CU13 y versiones posteriores, el programa de instalación ahora realiza copias de seguridad y restaura los archivos de configuración más comunes para que los administradores ya no necesiten restaurarlos manualmente o volver a aplicarlos.

El programa de instalación conserva las configuraciones personalizadas de la siguiente manera:

  1. El programa de instalación crea una copia de seguridad de los archivos existentes.
  2. El programa de instalación instala Exchange Server (o actualiza el existente Exchange Server) y sobrescribe los archivos existentes con las configuraciones y opciones predeterminadas presentes en el programa de instalación de Exchange.
  3. Finalmente, el programa de instalación restaura los archivos adecuados y los valores personalizados de las claves críticas almacenadas en los archivos de configuración previos a la actualización en los nuevos archivos de configuración copiados del programa de instalación de Exchange.

El programa de instalación conserva las opciones de configuración más críticas (si están presentes), que pueden incluir secciones enteras o determinados pares de clave-valor.

  1. appSettings Contiene muchos pares de clave-valor que configuran una variedad de opciones de configuración de la aplicación (por ejemplo, ruta de acceso de registro, tamaño de cola de mensajes, etc.). Cualquier par clave-valor creado con <add key> la etiqueta se conserva si esta sección está presente.

    Por ejemplo, en el siguiente archivo. ClientTunnelExpirationTime

    <configuration> 
    <appSettings> 
        <add key="ClientTunnelExpirationTime" value="30" /> 
    </appSettings> 
    </ configuration>
    
  2. Toda la proxySettings sección es crítica y se conserva.

  3. maxAllowedContentLength Se usa para especificar la longitud máxima del contenido (en bytes) de una solicitud.

    <system.webServer> 
        <security> 
        <requestFiltering> 
            <requestLimits maxAllowedContentLength="4194304" /> 
        </requestFiltering> 
        </security> 
    <system.webServer> 
    
  4. maxRequestLength se usa para especificar el tamaño máximo de la solicitud.

    <system.web> 
        <httpRuntime maxRequestLength="4194304" /> 
    </system.web> 
    
  5. maxReceivedMessageSize se utiliza en systembinding elementos AND custombinding para establecer el tamaño máximo (en bytes) de un mensaje que se puede recibir en un canal configurado con este enlace.

  6. maxStringContentLength está presente en ambos systembinding elementos y customBinding se usa para limitar el tamaño máximo de cadena que devuelve el lector XML.

  7. extendedProtectionPolicy se usa para establecer la directiva de protección extendida, que el servidor usa para validar las conexiones de cliente entrantes.

  8. defaultProxy se usa para configurar el servidor proxy HTTP.

Lista de archivos de configuración conservados junto con secciones y claves conservadas

Esta es la lista de todos los archivos de configuración junto con secciones y claves que se conservan automáticamente durante la actualización de CU.

Nota:

Las mitigaciones de reglas de reescritura de URL de IIS que se aplicaron en un nivel por sitio/por vDir no se conservarán con esta característica y, finalmente, el servicio de mitigación de emergencia de Exchange las volverá a aplicar si aún son aplicables a la CU que se instaló. Puede encontrar más información aquí.

No. Nombre del archivo de configuración Secciones conservadas Claves adicionales conservadas
1 <ExchangeInstallPath>\V15\Bin\ComplianceAuditService.exe.config appSettings -
2 <ExchangeInstallPath>\V15\Bin\EdgeTransport.exe.config appSettings -
3 <ExchangeInstallPath>\V15\Bin\Microsoft.Exchange.Diagnostics.Service.exe.config appSettings -
4 <ExchangeInstallPath>\V15\Bin\Microsoft.Exchange.Directory.TopologyService.exe.config appSettings maxReceivedMessageSize,
maxStringContentLength
5 <ExchangeInstallPath>\V15\Bin\Microsoft.Exchange.EdgeSyncSvc.exe.config appSettings -
6 <ExchangeInstallPath>\V15\Bin\Microsoft.Exchange.Mitigation.Service.exe.config appSettings -
9 <ExchangeInstallPath>\V15\Bin\Microsoft.Exchange.RpcClientAccess.Service.exe.config appSettings, defaultProxy maxReceivedMessageSize,
maxStringContentLength
10 <ExchangeInstallPath>\V15\Bin\Microsoft.Exchange.Search.Service.exe.config appSettings -
12 <ExchangeInstallPath>\V15\Bin\Microsoft.Exchange.Servicehost.exe.config appSettings, defaultProxy maxReceivedMessageSize,
maxStringContentLength
14 <ExchangeInstallPath>\V15\Bin\Microsoft.Exchange.Store.Service.exe.config appSettings -
17 <ExchangeInstallPath>\V15\Bin\MSExchangeCompliance.exe.config appSettings -
18 <ExchangeInstallPath>\V15\Bin\MSExchangeDelivery.exe.config appSettings -
19 <ExchangeInstallPath>\V15\Bin\MSExchangeFrontEndTransport.exe.config appSettings -
20 <ExchangeInstallPath>\V15\Bin\MSExchangeHMHost.exe.config appSettings -
21 <ExchangeInstallPath>\V15\Bin\MSExchangeHMRecovery.exe.config appSettings -
22 <ExchangeInstallPath>\V15\Bin\MSExchangeHMWorker.exe.config appSettings -
23 <ExchangeInstallPath>\V15\Bin\MSExchangeMailboxAssistants.exe.config appSettings -
24 <ExchangeInstallPath>\V15\Bin\MsExchangeMailboxReplication.exe.config appSettings, defaultProxy maxReceivedMessageSize,
maxStringContentLength
26 <ExchangeInstallPath>\V15\Bin\MSExchangeSubmission.exe.config appSettings -
27 <ExchangeInstallPath>\V15\Bin\MSExchangeThrottling.exe.config appSettings -
28 <ExchangeInstallPath>\V15\Bin\MSExchangeTransport.exe.config appSettings -
29 <ExchangeInstallPath>\V15\ClientAccess\PopImap\Microsoft.Exchange.Imap4.exe.config appSettings,
defaultProxy
-
30 <ExchangeInstallPath>\V15\ClientAccess\PopImap\Microsoft.Exchange.Imap4Service.exe.config appSettings -
31 <ExchangeInstallPath>\V15\ClientAccess\PopImap\Microsoft.Exchange.Pop3.exe.config appSettings,
defaultProxy
-
32 <ExchangeInstallPath>\V15\ClientAccess\PopImap\Microsoft.Exchange.Pop3Service.exe.config appSettings -
33 <ExchangeInstallPath>\V15\FrontEnd\PopImap\Microsoft.Exchange.Imap4.exe.config appSettings,
defaultProxy
-
34 <ExchangeInstallPath>\V15\FrontEnd\PopImap\Microsoft.Exchange.Imap4Service.exe.config appSettings -
35 <ExchangeInstallPath>\V15\FrontEnd\PopImap\Microsoft.Exchange.Pop3.exe.config appSettings,
defaultProxy
-
36 <ExchangeInstallPath>\V15\FrontEnd\PopImap\Microsoft.Exchange.Pop3Service.exe.config appSettings -
37 <ExchangeInstallPath>\V15\Bin\Microsoft.Exchange.AddressBook.Service.dll.config appSettings -
38 <ExchangeInstallPath>\V15\Bin\Microsoft.Exchange.Management.Transport.dll.config appSettings -
39 <ExchangeInstallPath>\V15\TransportRoles\agents\Antimalware\Microsoft.Exchange.Transport.Agent.Malware.dll.config appSettings -
40 <ExchangeInstallPath>\V15\Bin\MSExchangeUM.config appSettings -
41 <ExchangeInstallPath>\V15\ClientAccess\Autodiscover\web.config appSettings maxReceivedMessageSize
42 <ExchangeInstallPath>\V15\ClientAccess\ecp\web.config appSettings maxReceivedMessageSize,
maxStringContentLength
43 <ExchangeInstallPath>\V15\ClientAccess\ecp\DLPPolicy\Web.config - maxRequestLength
44 <ExchangeInstallPath>\V15\ClientAccess\ecp\Handlers\Web.config - maxRequestLength
45 <ExchangeInstallPath>\V15\ClientAccess\ecp\PersonalSettings\Web.config - maxRequestLength
46 <ExchangeInstallPath>\V15\ClientAccess\ecp\UsersGroups\Web.config - maxRequestLength
47 <ExchangeInstallPath>\V15\ClientAccess\exchweb\ews\web.config appSettings,
defaultProxy,
extendedProtectionPolicy
maxAllowedContentLength,
maxReceivedMessageSize,
maxRequestLength,
maxStringContentLength
48 <ExchangeInstallPath>\V15\ClientAccess\mapi\emsmdb\web.config appSettings,
defaultProxy
maxAllowedContentLength,
maxReceivedMessageSize,
maxRequestLength,
maxStringContentLength
49 <ExchangeInstallPath>\V15\ClientAccess\mapi\nspi\web.config appSettings,
defaultProxy
maxAllowedContentLength,
maxRequestLength
50 <ExchangeInstallPath>\V15\ClientAccess\OAB\web.config appSettings -
52 <ExchangeInstallPath>\V15\ClientAccess\PowerShell\web.config appSettings -
53 <ExchangeInstallPath>\V15\ClientAccess\PowerShell-Proxy\web.config appSettings -
54 <ExchangeInstallPath>\V15\ClientAccess\PushNotifications\web.config appSettings maxReceivedMessageSize
55 <ExchangeInstallPath>\V15\ClientAccess\rest\web.config appSettings maxAllowedContentLength,
maxRequestLength
56 <ExchangeInstallPath>\V15\ClientAccess\RpcProxy\web.config appSettings -
57 <ExchangeInstallPath>\V15\ClientAccess\Sync\web.config appSettings,
defaultProxy
MaxDocumentDataSize,
maxRequestLength,
maxAllowedContentLength
58 <ExchangeInstallPath>\V15\FrontEnd\HttpProxy\autodiscover\web.config appSettings -
59 <ExchangeInstallPath>\V15\FrontEnd\HttpProxy\ecp\web.config appSettings maxAllowedContentLength,
maxRequestLength
60 <ExchangeInstallPath>\V15\FrontEnd\HttpProxy\ews\web.config appSettings maxAllowedContentLength,
maxRequestLength
61 <ExchangeInstallPath>\V15\FrontEnd\HttpProxy\mapi\web.config appSettings maxAllowedContentLength,
maxRequestLength
62 <ExchangeInstallPath>\V15\FrontEnd\HttpProxy\oab\web.config appSettings -
63 <ExchangeInstallPath>\V15\FrontEnd\HttpProxy\owa\web.config appSettings maxAllowedContentLength,
maxRequestLength
64 <ExchangeInstallPath>\V15\FrontEnd\HttpProxy\powershell\web.config appSettings -
65 <ExchangeInstallPath>\V15\FrontEnd\HttpProxy\pushnotifications\web.config appSettings maxAllowedContentLength,
maxRequestLength
66 <ExchangeInstallPath>\V15\FrontEnd\HttpProxy\ReportingWebService\web.config appSettings -
67 <ExchangeInstallPath>\V15\FrontEnd\HttpProxy\rest\web.config appSettings maxAllowedContentLength,
maxRequestLength
68 <ExchangeInstallPath>\V15\FrontEnd\HttpProxy\rpc\web.config appSettings maxAllowedContentLength,
maxRequestLength
69 <ExchangeInstallPath>\V15\FrontEnd\HttpProxy\sync\web.config appSettings maxRequestLength,
maxAllowedContentLength
70 <ExchangeInstallPath>\V15\FIP-FS\Data\Configuration.xml ProxySettings -
71 <ExchangeInstallPath>\V15\Bin\Search\Ceres\Runtime\1.0\Noderunner.exe.config - memoryLimitMegabytes

Una vez finalizada la instalación, se mostrarán los siguientes mensajes para indicar que todas las opciones de configuración conservadas se restauraron correctamente.

Modo GUI

Modo desatendido

La copia de seguridad de los archivos de configuración conservados se almacena %ProgramFiles%\Microsoft\Exchange Server\V15\Config en subcarpetas que utilizan un formato de nomenclatura de v_<ExchangeVersion>_<Timestamp>.

Nota:

Si estos archivos no son necesarios una vez finalizada la instalación, se pueden eliminar de forma segura.

El programa de instalación conserva la configuración personalizada de manera predeterminada. Si no desea utilizar esta característica, puede deshabilitarla creando una REG_SZ entrada DisablePreservation en HKLM\SOFTWARE\Microsoft\ExchangeServer\v15\Setup y estableciendo el valor en 1.

El par clave-valor se puede crear mediante la ejecución del siguiente comando de PowerShell:

New-ItemProperty -Path HKLM:\SOFTWARE\Microsoft\ExchangeServer\v15\Setup -Name "DisablePreservation" -Value 1 -Type String

Si la instalación de Exchange se ejecuta después de establecer la clave de registro en 1, la instalación no realizará una copia de seguridad ni restaurará ningún par clave/valor en ninguna de las configuraciones.

Clave de registro Valor del Registro Comportamiento de la configuración de Exchange
DisablePreservation (Tipo: REG_SZ) 1 Se restablecen todos los pares de clave-valor de los archivos de configuración y no se almacena ninguna copia de seguridad de la configuración previa a la actualización (este comportamiento es equivalente a actualizaciones anteriores de CU).
DisablePreservation (Tipo: REG_SZ) NULL El programa de instalación crea una copia de seguridad de las configuraciones previas a la actualización y conserva determinado par clave/valor en las configuraciones previas a la actualización en las nuevas configuraciones.
DisablePreservation (Tipo: REG_SZ) Cualquier otro valor El programa de instalación crea una copia de seguridad de las configuraciones previas a la actualización y conserva determinado par clave/valor en las configuraciones previas a la actualización en las nuevas configuraciones.

Si el programa de instalación no puede restaurar toda la configuración a su estado anterior, muestra una advertencia.

Modo desatendido

Modo atendido

Como siguiente paso, los administradores pueden analizar el archivo de registro de configuración para ver qué configuración no se pudo conservar. Una o más entradas pueden estar presentes en el archivo de registro para indicar qué configuración no se pudo conservar:

  1. Excepción encontrada durante la lectura del archivo de configuración: <configFileName>. Saltarse la preservación.
  2. Excepción encontrada al guardar <Preservation cmdlet name> cambios en: <configFileName>.
  3. Excepción encontrada durante la validación del esquema del archivo de configuración: <configFileName>. Saltarse la preservación.
  4. <Preservation cmdlet name> Error por: <configFileName>

Los administradores pueden copiar manualmente cualquier archivo de configuración de la ubicación de copia de seguridad a la ubicación requerida sobrescribiendo los archivos creados por la instalación. Esto también restaura estos archivos a su estado previo a la instalación.