Erhaltung der benutzerdefinierten Konfiguration in Exchange Server

GILT FÜR:no-img-162016 yes-img-192019 yes-img-seSubscription Edition

Übersicht

Nach der Installation von Exchange Server besteht eine allgemeine Administratoraufgabe darin, Einstellungen anzupassen, z. B. clientspezifische Größenbeschränkungen für Nachrichten. Diese Einstellungen werden normalerweise in web.config, sharedweb.configund anderen Konfigurationsdateien auf dem Exchange-Server konfiguriert.

In der Vergangenheit bestand eine der Herausforderungen für Exchange-Serveradministratoren darin, dass jedes Mal, wenn ein kumulatives Update (CU) installiert wird, diese Dateien und die darin enthaltenen benutzerdefinierten Einstellungen vom Setup überschrieben werden, wodurch ein Administrator gezwungen ist, ihre Einstellungen zu sichern/wiederherzustellen oder sie nach jeder CU-Installation erneut anzuwenden.

Mit Exchange Server 2019 CU13 und höher wird nun die gängigste Konfigurationsdatei gesichert und wiederhergestellt, sodass Administratoren diese nicht mehr manuell wiederherstellen oder erneut anwenden müssen.

Setup behält benutzerdefinierte Konfigurationen folgendermaßen bei:

  1. Setup erstellt eine Sicherung der vorhandenen Dateien.
  2. Setup installiert Exchange Server (oder aktualisiert vorhandene Exchange Server) und überschreibt vorhandene Dateien mit Standardkonfigurationen und Einstellungen, die in Exchange Setup vorhanden sind.
  3. Setup stellt schließlich die entsprechenden Dateien und benutzerdefinierten Werte kritischer Schlüssel, die in den Konfigurationsdateien vor dem Upgrade gespeichert sind, in den neuen Konfigurationsdateien wieder her, die aus Exchange Setup kopiert wurden.

Setup behält die wichtigsten Konfigurationseinstellungen (sofern vorhanden) bei, die ganze Abschnitte oder bestimmte Schlüssel-Wert-Paare umfassen können.

  1. appSettings Enthält viele Schlüssel-Wert-Paare, die eine Reihe von Anwendungseinstellungen konfigurieren (z. B. Protokollierungspfad, Größe der Nachrichtenwarteschlange usw.). Jedes mit <add key> dem Tag erstellte Schlüssel-Wert-Paar wird beibehalten, wenn dieser Abschnitt vorhanden ist.

    In der folgenden Datei wird beispielsweise Folgendes ClientTunnelExpirationTime beibehalten.

    <configuration> 
    <appSettings> 
        <add key="ClientTunnelExpirationTime" value="30" /> 
    </appSettings> 
    </ configuration>
    
  2. Der gesamte proxySettings Abschnitt ist kritisch und erhalten geblieben.

  3. maxAllowedContentLength wird verwendet, um die maximale Länge des Inhalts (in Bytes) in einer Anforderung anzugeben.

    <system.webServer> 
        <security> 
        <requestFiltering> 
            <requestLimits maxAllowedContentLength="4194304" /> 
        </requestFiltering> 
        </security> 
    <system.webServer> 
    
  4. maxRequestLength wird verwendet, um die maximale Anforderungsgröße anzugeben.

    <system.web> 
        <httpRuntime maxRequestLength="4194304" /> 
    </system.web> 
    
  5. maxReceivedMessageSize wird in systembinding und custombinding verwendet, um die maximale Größe (in Bytes) für eine Nachricht festzulegen, die auf einem mit dieser Bindung konfigurierten Kanal empfangen werden kann.

  6. maxStringContentLength ist sowohl in als auch systembindingcustomBinding in and-Elementen vorhanden und wird verwendet, um die maximale Zeichenfolgengröße zu begrenzen, die der XML-Reader zurückgibt.

  7. extendedProtectionPolicy wird verwendet, um die erweiterte Schutzrichtlinie festzulegen, die vom Server verwendet wird, um eingehende Clientverbindungen zu überprüfen.

  8. defaultProxy wird zum Konfigurieren des HTTP-Proxyservers verwendet.

Liste der erhaltenen Konfigurationsdateien zusammen mit erhaltenen Abschnitten und Schlüsseln

Hier ist die Liste aller Konfigurationsdateien zusammen mit Abschnitten und Schlüsseln, die während des CU-Upgrades automatisch beibehalten werden.

Hinweis

Risikominderungen für IIS-URL-Rewrite-Regeln , die auf einer Site-/Per-vDir-Ebene angewendet wurden, werden von diesem Feature nicht beibehalten und schließlich vom Exchange-Notfallminderungsdienst erneut angewendet, wenn sie für das installierte CU noch anwendbar sind. Weitere Informationen finden Sie hier.

Nein Name der Konfigurationsdatei Abschnitte beibehalten Zusätzliche Schlüssel beibehalten
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

Nach Abschluss des Setups werden die folgenden Meldungen angezeigt, um anzugeben, dass alle beibehaltenen Konfigurationseinstellungen erfolgreich wiederhergestellt wurden.

GUI-Modus

Unbeaufsichtigter Modus

Die Sicherung der beibehaltenen Konfigurationsdateien wird in %ProgramFiles%\Microsoft\Exchange Server\V15\Config Unterordnern gespeichert, die das Namensformat .v_<ExchangeVersion>_<Timestamp>

Hinweis

Wenn diese Dateien nach Abschluss des Setups nicht mehr benötigt werden, können sie sicher gelöscht werden.

Setup behält standardmäßig benutzerdefinierte Einstellungen bei. Wenn Sie dieses Feature nicht verwenden möchten, können Sie es deaktivieren, indem Sie einen REG_SZ Eintrag DisablePreservation unter HKLM\SOFTWARE\Microsoft\ExchangeServer\v15\Setup erstellen und den Wert auf 1setzen.

Das Schlüssel-Wert-Paar kann durch Ausführen des folgenden PowerShell-Befehls erstellt werden:

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

Wenn das Exchange-Setup ausgeführt wird, nachdem der Registrierungsschlüssel auf 1festgelegt wurde, wird das Setup in keiner der Konfigurationen ein Schlüssel/Wert-Paar sichern oder wiederherstellen.

Registrierungsschlüssel Registrierungswert Setupverhalten von Exchange
DisablePreservation (Type: REG_SZ) 1 Alle Schlüssel-Wert-Paare in den Konfigurationsdateien werden zurückgesetzt, und es wird keine Sicherungskopie der Konfiguration vor dem Upgrade gespeichert (dieses Verhalten entspricht vorherigen CU-Upgrades).
DisablePreservation (Type: REG_SZ) NULL Setup erstellt eine Sicherung der Konfigurationen vor dem Upgrade und behält bestimmte Schlüssel-Wert-Paare in den neuen Konfigurationen vor dem Upgrade bei.
DisablePreservation (Type: REG_SZ) Beliebiger anderer Wert Setup erstellt eine Sicherung der Konfigurationen vor dem Upgrade und behält bestimmte Schlüssel-Wert-Paare in den neuen Konfigurationen vor dem Upgrade bei.

Wenn Setup nicht alle Einstellungen in den vorherigen Zustand zurückversetzen kann, wird eine Warnung angezeigt.

Unbeaufsichtigter Modus

Beaufsichtigter Modus

Im nächsten Schritt können Administratoren die Setupprotokolldatei analysieren, um festzustellen, welche Einstellungen nicht beibehalten werden konnten. Möglicherweise sind ein oder mehrere Einträge in der Protokolldatei vorhanden, die angeben, welche Einstellungen nicht beibehalten werden konnten:

  1. Beim Lesen der Konfigurationsdatei ist eine Ausnahme aufgetreten: <configFileName>. Erhaltung überspringen.
  2. Beim Speichern der <Preservation cmdlet name> Änderungen ist eine Ausnahme aufgetreten an: <configFileName>.
  3. Während der Schemavalidierung der Konfigurationsdatei ist eine Ausnahme aufgetreten: <configFileName>. Erhaltung überspringen.
  4. <Preservation cmdlet name> Fehler für: <configFileName>

Administratoren können Konfigurationsdateien manuell vom Sicherungsspeicherort an den erforderlichen Speicherort kopieren, indem sie die vom Setup erstellten Dateien überschreiben. Dadurch werden auch diese Dateien in den Zustand vor der Installation zurückversetzt.