Exchange Server der beibehaltung der benutzerdefinierten Konfiguration

Übersicht

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

In der Vergangenheit besteht eine der Herausforderungen für Exchange-Serveradministratoren darin, dass bei jeder Installation eines kumulativen Updates (CU) diese Dateien und die darin enthaltenen benutzerdefinierten Einstellungen vom Setup überschrieben werden, wodurch ein Administrator gezwungen wird, seine Einstellungen zu sichern/wiederherzustellen oder sie nach jeder CU-Installation erneut anzuweisen.

Mit Exchange Server 2019 CU13 und höher sichert setup jetzt die am häufigsten verwendeten Konfigurationsdateien und stellt sie wieder her, sodass Administratoren sie nicht mehr manuell wiederherstellen oder erneut anwenden müssen.

Setup behält benutzerdefinierte Konfigurationen wie folgt 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 im Exchange-Setup vorhanden sind.
3. Setup stellt schließlich die entsprechenden Dateien und benutzerdefinierten Werte kritischer Schlüssel wieder her, die in den Konfigurationsdateien vor dem Upgrade in den neuen Konfigurationsdateien gespeichert sind, die aus dem Exchange-Setup kopiert wurden.

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

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

   In der folgenden Datei wird z. B ClientTunnelExpirationTime . beibehalten.

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

2. Der gesamte proxySettings Abschnitt ist kritisch und wird beibehalten.

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 -Elementen verwendet, um die maximale Größe (in Bytes) für eine Nachricht festzulegen, die auf einem Kanal empfangen werden kann, der mit dieser Bindung konfiguriert ist.

6. maxStringContentLength ist sowohl in - als auch systembindingcustomBinding -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 beibehaltenen Konfigurationsdateien zusammen mit beibehaltenen 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 Ebene pro Standort/pro vDir angewendet wurden, werden von diesem Feature nicht beibehalten und schließlich vom Exchange Emergency Mitigation-Dienst erneut angewendet, wenn sie weiterhin für das installierte CU gelten. Weitere Informationen finden Sie hier.

Nein	Konfigurationsdateiname	Beibehaltene Abschnitte	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 Benennungsformat verwenden v_<ExchangeVersion>_<Timestamp>.

Hinweis

Wenn diese Dateien nach Abschluss des Setups nicht 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 1festlegen.

Das Schlüssel-Wert-Paar kann erstellt werden, indem Sie den folgenden PowerShell-Befehl ausführen:

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 kein Schlüssel-Wert-Paar in einer der Konfigurationen sichern oder wiederherstellen.

Registrierungsschlüssel	Registrierungswert	Exchange-Setupverhalten
DisablePreservation (Typ: REG_SZ)	1	Alle Schlüssel-Wert-Paare in Konfigurationsdateien werden zurückgesetzt, und es wird keine Sicherung der Preupgrade-Konfiguration gespeichert (dieses Verhalten entspricht vorherigen CU-Upgrades).
DisablePreservation (Typ: REG_SZ)	NULL	Setup erstellt eine Sicherung von Preupgrade-Konfigurationen und behält bestimmte Schlüssel-Wert-Paare in Preupgrade-Konfigurationen für die neuen Konfigurationen bei.
DisablePreservation (Typ: REG_SZ)	Jeder andere Wert	Setup erstellt eine Sicherung von Preupgrade-Konfigurationen und behält bestimmte Schlüssel-Wert-Paare in Preupgrade-Konfigurationen für die neuen Konfigurationen bei.

Wenn Setup nicht alle Einstellungen in ihren vorherigen Zustand wiederherstellen 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 ist in der Protokolldatei mindestens ein Eintrag vorhanden, um anzugeben, welche Einstellungen nicht beibehalten werden konnten:

1. Ausnahme beim Lesen der Konfigurationsdatei: <configFileName>. Überspringen der Erhaltung.
2. Ausnahme beim Speichern von <Preservation cmdlet name> Änderungen in: <configFileName>.
3. Ausnahme bei der Schemaüberprüfung der Konfigurationsdatei: <configFileName>. Überspringen der Erhaltung.
4. <Preservation cmdlet name> Fehler für: <configFileName>

Administratoren können alle Konfigurationsdateien manuell vom Sicherungsspeicherort an den erforderlichen Speicherort kopieren, indem sie die vom Setup erstellten Dateien überschreiben. Dadurch wird auch der Zustand dieser Dateien vor dem Setup wiederhergestellt.