Preservação da configuração personalizada do Exchange Server

APLICA-SE A:2016 2019 Subscription Edition

Visão Geral

Após a instalação do Exchange Server, uma tarefa comum do administrador é personalizar as configurações, como limites de tamanho de mensagem específicos do cliente. Essas configurações são normalmente definidas no web.config, sharedweb.confige e outros arquivos de configuração no servidor Exchange.

Historicamente, um dos desafios para os administradores do Exchange Server é que, sempre que uma (Atualização Cumulativa) é instalada, esses arquivos e as configurações personalizadas neles são substituídos pela Instalação, forçando um administrador a fazer backup/restaurar suas configurações ou reaplicá-las após cada instalação de.

Com o Exchange Server 2019 CU13 e posterior, a Instalação agora faz backup e restaura os arquivos de configuração mais comuns para que os administradores não precisem mais restaurá-los manualmente ou reaplicá-los.

A instalação preserva as configurações personalizadas da seguinte maneira:

1. A instalação cria um backup dos arquivos existentes.
2. A instalação instala o Exchange Server (ou atualiza o Exchange Server existente) e substitui os arquivos existentes pelas configurações padrão e pelas definições presentes na Instalação do Exchange.
3. A Instalação finalmente restaura os arquivos apropriados e os valores personalizados de chaves críticas armazenadas nos arquivos de configuração pré-atualização nos novos arquivos de configuração copiados da Instalação do Exchange.

A instalação preserva as definições de configuração mais críticas (se presentes), que podem incluir seções inteiras ou determinados pares de chave-valor.

1. appSettings Contém muitos pares de chave-valor que definem um intervalo de configurações de aplicativo (por exemplo, caminho de log, tamanho da fila de mensagens etc.). Qualquer par de valores-chave criado usando <add key> uma marca será preservado se esta seção estiver presente.

   Por exemplo, no arquivo a seguir, ClientTunnelExpirationTime é preservado.

   <configuration> 
   <appSettings> 
       <add key="ClientTunnelExpirationTime" value="30" /> 
   </appSettings> 
   </ configuration>
   

2. Toda proxySettings a seção é crítica e está preservada.

3. maxAllowedContentLength é usado para especificar o comprimento máximo do conteúdo (em bytes) em uma solicitação.

   <system.webServer> 
       <security> 
       <requestFiltering> 
           <requestLimits maxAllowedContentLength="4194304" /> 
       </requestFiltering> 
       </security> 
   <system.webServer> 
   

4. maxRequestLength é usado para especificar o tamanho máximo da solicitação.

   <system.web> 
       <httpRuntime maxRequestLength="4194304" /> 
   </system.web> 
   

5. maxReceivedMessageSize é usado nos systembinding elementos and custombinding para definir o tamanho máximo (em bytes) de uma mensagem que pode ser recebida em um canal configurado com essa associação.

6. maxStringContentLength está presente em ambos os systembinding elementos and customBinding e é usado para limitar o tamanho máximo da cadeia de caracteres que o leitor XML retorna.

7. extendedProtectionPolicy é usada para definir a política de Proteção Estendida, que é usada pelo servidor para validar as conexões de cliente de entrada.

8. defaultProxy é usado para configurar o servidor proxy HTTP.

Lista de arquivos de configuração preservados junto com seções e chaves preservadas

Aqui está a lista de todos os arquivos de configuração, juntamente com seções e chaves que são preservadas automaticamente durante a atualização da.

Após a conclusão da Instalação, serão exibidas as seguintes mensagens para indicar que todas as configurações preservadas foram restauradas com êxito.

Modo GUI

Modo autônomo

O backup dos arquivos de configuração preservados é armazenado em subpastas que, usando %ProgramFiles%\Microsoft\Exchange Server\V15\Config um formato de nomenclatura de v_<ExchangeVersion>_<Timestamp>.

A instalação preserva as configurações personalizadas por padrão. Se você não quiser usar esse recurso, poderá desativá-lo criando uma REG_SZ entrada DisablePreservation em HKLM\SOFTWARE\Microsoft\ExchangeServer\v15\Setup e definindo o valor como 1.

O par chave/valor pode ser criado executando o seguinte comando do PowerShell:

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

Se a Instalação do Exchange for executada depois de definir a chave do registro como 1, a instalação não fará backup nem restaurará nenhum par chave/valor em nenhuma das configurações.

Se a Configuração não conseguir restaurar todas as configurações para o estado anterior, ela exibirá um aviso.

Modo Autônomo

Modo Assistido

Como próxima etapa, os administradores podem analisar o arquivo de log de Instalação para ver quais configurações não puderam ser preservadas. Uma ou mais entradas podem estar presentes no arquivo de log para indicar quais configurações não puderam ser preservadas:

1. Exceção encontrada durante a leitura do arquivo de configuração: <configFileName>. Ignorando a preservação.
2. Exceção encontrada ao salvar <Preservation cmdlet name> alterações para: <configFileName>.
3. Exceção encontrada durante a validação de esquema do arquivo de configuração: <configFileName>. Ignorando a preservação.
4. <Preservation cmdlet name> Com falha para: <configFileName>

Os administradores podem copiar manualmente quaisquer arquivos de configuração do local de backup para o local necessário, substituindo os arquivos criados pela Instalação. Isso também restaura esses arquivos para o estado pré-instalação.