Exchange Server preservação de configuração personalizada

Visão geral

Depois de instalar Exchange Server, uma tarefa de administrador comum é personalizar configurações, como limites de tamanho de mensagem específicos do cliente. Essas configurações normalmente são configuradas em , sharedweb.confige em web.configoutros arquivos de configuração no servidor exchange.

Historicamente, um dos desafios para os administradores do servidor do Exchange é que cada vez que uma CU (Atualização Cumulativa) é instalada, esses arquivos e as configurações personalizadas nele são substituídos pela Instalação, forçando um administrador a fazer backup/restaurar suas configurações ou aplica-los novamente após cada instalação de CU.

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 reaplica-los.

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

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

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

1. appSettings contém muitos pares de valores principais que configuram um intervalo de configurações de aplicativo (por exemplo, caminho de registro em log, tamanho da fila de mensagens etc.). Qualquer par de valor de chave criado usando <add key> 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. A seção inteira proxySettings é crítica e é 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 em systembinding elementos e custombinding para definir o tamanho máximo (em bytes) para uma mensagem que pode ser recebida em um canal configurado com essa associação.

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

7. extendedProtectionPolicy é usado para definir a política de proteção estendida, que é usada pelo servidor para validar 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 CU.

Observação

As mitigações de regra de reescrita de URL do IIS que foram aplicadas em um nível por site/por vDir não serão preservadas por esse recurso e, eventualmente, serão reaplicadas pelo serviço de Mitigação de Emergência do Exchange se ainda forem aplicáveis à CU instalada. Mais informações podem ser encontradas aqui.

Não.	Nome do arquivo de configuração	Seções preservadas	Chaves adicionais preservadas
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

Após a conclusão da Instalação, ela exibirá 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 %ProgramFiles%\Microsoft\Exchange Server\V15\Config subpastas que usam um formato de nomenclatura de v_<ExchangeVersion>_<Timestamp>.

Observação

Se esses arquivos não forem necessários após a conclusão da Instalação, eles poderão ser excluídos com segurança.

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

O par de 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 Configuração do Exchange for executada depois de definir o regkey como , a 1configuração não fará backup nem restaurará nenhum par de chave/valor em qualquer uma das configurações.

Chave do Registro	Valor de Registro	Comportamento de configuração do Exchange
DesabilitarPreservação (Tipo: REG_SZ)	1	Todos os pares de valor de chave em arquivos de configuração são redefinidos e nenhum backup da configuração de pré-graduação é armazenado (esse comportamento é equivalente a atualizações anteriores da CU).
DesabilitarPreservação (Tipo: REG_SZ)	NULL	A instalação cria um backup de configurações de pré-graduação e preserva determinado par de chave/valor em configurações de pré-graduação para as novas configurações.
DesabilitarPreservação (Tipo: REG_SZ)	Qualquer outro valor	A instalação cria um backup de configurações de pré-graduação e preserva determinado par de chave/valor em configurações de pré-graduação para as novas configurações.

Se a Instalação não puder restaurar todas as configurações no 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 poderiam ser preservadas. Uma ou mais entradas podem estar presentes no arquivo de log para indicar quais configurações não poderiam ser preservadas:

1. Exceção encontrada durante a leitura do arquivo de configuração: <configFileName>. Ignorando a preservação.
2. Exceção encontrada durante a salvação <Preservation cmdlet name> de alterações em: <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> falha em: <configFileName>

Os administradores podem copiar manualmente todos os arquivos de configurações do local de backup para o local necessário substituindo os arquivos criados pela Configuração. Isso também restaura esses arquivos em seu estado de pré-instalação.