Compartilhar via


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

APLICA-SE A:no-img-162016 yes-img-192019 yes-img-seSubscription Edition

Visão Geral

Depois de instalar Exchange Server, uma tarefa de administrador comum consiste em personalizar definições, como limites de tamanho de mensagens específicos do cliente. Normalmente, estas definições são configuradas no web.config, sharedweb.confige noutros ficheiros de configuração no servidor Exchange.

Historicamente, um dos desafios para os administradores de servidores do Exchange é que sempre que uma Atualização Cumulativa () é instalada, estes ficheiros e as definições personalizadas aí presentes são substituídos pela Configuração, forçando um administrador a fazer uma cópia de segurança/restaurar as respetivas definições ou a voltar a aplicá-las após cada instalação da.

Com o Exchange Server 2019 CU13 e posterior, a Configuração faz agora uma cópia de segurança e restaura os ficheiros de configuração mais comuns para que os administradores já não precisem de os restaurar manualmente ou voltar a aplicá-los.

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

  1. A configuração cria uma cópia de segurança dos ficheiros existentes.
  2. A configuração instala Exchange Server (ou atualiza Exchange Server existentes) e substitui os ficheiros existentes por configurações e definições predefinidas presentes na Configuração do Exchange.
  3. A configuração finalmente restaura os ficheiros adequados e os valores personalizados de chaves críticas armazenadas nos ficheiros de configuração de pré-atualização nos novos ficheiros de configuração copiados da Configuração do Exchange.

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

  1. appSettings contém muitos pares chave-valor que configuram um intervalo de definições de aplicação (por exemplo, caminho de registo, tamanho da fila de mensagens, etc.). Se esta secção estiver presente, todos os pares chave-valor criados com <add key> etiqueta são preservados.

    Por exemplo, no ficheiro seguinte, ClientTunnelExpirationTime é preservado.

    <configuration> 
    <appSettings> 
        <add key="ClientTunnelExpirationTime" value="30" /> 
    </appSettings> 
    </ configuration>
    
  2. Toda a proxySettings secção é crítica e preservada.

  3. maxAllowedContentLength é utilizado para especificar o comprimento máximo de conteúdo (em bytes) num pedido.

    <system.webServer> 
        <security> 
        <requestFiltering> 
            <requestLimits maxAllowedContentLength="4194304" /> 
        </requestFiltering> 
        </security> 
    <system.webServer> 
    
  4. maxRequestLength é utilizado para especificar o tamanho máximo do pedido.

    <system.web> 
        <httpRuntime maxRequestLength="4194304" /> 
    </system.web> 
    
  5. maxReceivedMessageSize é utilizado em systembinding e custombinding elementos para definir o tamanho máximo (em bytes) para uma mensagem que pode ser recebida num canal configurado com este enlace.

  6. maxStringContentLength está presente em ambos os systembinding elementos e customBinding e é utilizado para limitar o tamanho máximo de cadeia que o leitor XML devolve.

  7. extendedProtectionPolicy é utilizado para definir a política de proteção alargada, que é utilizada pelo servidor para validar as ligações de cliente de entrada.

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

Lista de ficheiros de configuração preservados juntamente com secções e chaves preservadas

Eis a lista de todos os ficheiros de configuração, juntamente com secções e chaves que são automaticamente preservadas durante a atualização da.

Observação

As mitigações de regras de reescrita de URL do IIS aplicadas a um nível por site/por vDir não serão preservadas por esta funcionalidade e, eventualmente, serão reaplicadas pelo serviço de Mitigação de Emergência do Exchange se ainda forem aplicáveis à que foi instalada. Pode encontrar mais informações aqui.

Não. Nome do Ficheiro de Configuração Secçõ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 Configuração, serão apresentadas as seguintes mensagens para indicar que todas as definições de configuração preservadas foram restauradas com êxito.

Modo GUI

Modo automática

A cópia de segurança dos ficheiros de configuração preservados é armazenada em %ProgramFiles%\Microsoft\Exchange Server\V15\Config subpastas que utilizam um formato de nomenclatura de v_<ExchangeVersion>_<Timestamp>.

Observação

Se estes ficheiros não forem necessários após a conclusão da Configuração, podem ser eliminados em segurança.

A configuração preserva as definições personalizadas por predefinição. Se não quiser utilizar esta funcionalidade, pode desativá-la ao criar uma REG_SZ entrada DisablePreservation em HKLM\SOFTWARE\Microsoft\ExchangeServer\v15\Setup e definir o valor como 1.

O par chave/valor pode ser criado ao executar 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 a chave de registo como 1, a configuração não efetuará cópias de segurança nem restaurará nenhum par chave/valor em nenhuma das configurações.

Chave do Registo Valor de Registro Comportamento de configuração do Exchange
DisablePreservation (Tipo: REG_SZ) 1 Todos os pares de valores chave em ficheiros de configuração são repostos e não é armazenada nenhuma cópia de segurança da configuração de pré-atualização (este comportamento é equivalente a atualizações de anteriores).
DisablePreservation (Tipo: REG_SZ) NULL A configuração cria uma cópia de segurança de configurações de pré-atualização e preserva determinado par chave/valor em configurações de pré-atualização para as novas configurações.
DisablePreservation (Tipo: REG_SZ) Qualquer outro valor A configuração cria uma cópia de segurança de configurações de pré-atualização e preserva determinado par chave/valor em configurações de pré-atualização para as novas configurações.

Se a Configuração não conseguir restaurar todas as definições para o estado anterior, será apresentado um aviso.

Modo Automática

Modo Assistido

Como passo seguinte, os administradores podem analisar o ficheiro de registo de Configuração para ver que definições não puderam ser preservadas. Uma ou mais entradas podem estar presentes no ficheiro de registo para indicar que definições não puderam ser preservadas:

  1. Exceção encontrada durante a leitura do ficheiro de configuração: <configFileName>. A ignorar a preservação.
  2. Exceção encontrada durante a gravação <Preservation cmdlet name> de alterações a: <configFileName>.
  3. Exceção encontrada durante a validação do esquema do ficheiro de configuração: <configFileName>. A ignorar a preservação.
  4. <Preservation cmdlet name> falha para: <configFileName>

Os administradores podem copiar manualmente quaisquer ficheiros de configuração da localização da cópia de segurança para a localização necessária ao substituir os ficheiros criados pela Configuração. Isto também restaura estes ficheiros para o estado de pré-configuração.