Exchange Server la conservation de la configuration personnalisée

Vue d’ensemble

Après l’installation de Exchange Server, une tâche d’administration courante consiste à personnaliser les paramètres, tels que les limites de taille des messages spécifiques au client. Ces paramètres sont généralement configurés dans web.config, sharedweb.configet d’autres fichiers de configuration sur le serveur Exchange.

Historiquement, l’un des défis pour les administrateurs de serveur Exchange est que chaque fois qu’une mise à jour cumulative (CU) est installée, ces fichiers et les paramètres personnalisés qui s’y trouvent sont remplacés par le programme d’installation, ce qui force un administrateur à sauvegarder/restaurer leurs paramètres, ou à les réappliquer après chaque installation de cu.

Avec Exchange Server 2019 CU13 et versions ultérieures, le programme d’installation sauvegarde et restaure désormais les fichiers de configuration les plus courants afin que les administrateurs n’ont plus besoin de les restaurer manuellement ou de les réappliquer.

Le programme d’installation conserve les configurations personnalisées de la manière suivante :

1. Le programme d’installation crée une sauvegarde des fichiers existants.
2. Le programme d’installation installe Exchange Server (ou met à niveau les Exchange Server existants) et remplace les fichiers existants par les configurations et paramètres par défaut présents dans le programme d’installation d’Exchange.
3. Le programme d’installation restaure enfin les fichiers appropriés et les valeurs personnalisées des clés critiques stockées dans les fichiers de configuration de pré-mise à niveau dans les nouveaux fichiers de configuration copiés à partir du programme d’installation d’Exchange.

Le programme d’installation conserve les paramètres de configuration les plus critiques (le cas échéant), qui peuvent inclure des sections entières ou certaines paires clé-valeur.

1. appSettings contient de nombreuses paires clé-valeur qui configurent une plage de paramètres d’application (par exemple, chemin de journalisation, taille de la file d’attente des messages, etc.). Toute paire clé-valeur créée à l’aide <add key> de la balise est conservée si cette section est présente.

   Par exemple, dans le fichier suivant, ClientTunnelExpirationTime est conservé.

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

2. La section entière proxySettings est critique et est conservée.

3. maxAllowedContentLength est utilisé pour spécifier la longueur maximale du contenu (en octets) dans une requête.

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

4. maxRequestLength est utilisé pour spécifier la taille maximale de la requête.

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

5. maxReceivedMessageSize est utilisé dans systembinding les éléments et custombinding pour définir la taille maximale (en octets) d’un message qui peut être reçu sur un canal configuré avec cette liaison.

6. maxStringContentLength est présent dans les systembinding éléments et customBinding et est utilisé pour limiter la taille de chaîne maximale retournée par le lecteur XML.

7. extendedProtectionPolicy est utilisé pour définir la stratégie de protection étendue, qui est utilisée par le serveur pour valider les connexions clientes entrantes.

8. defaultProxy est utilisé pour configurer le serveur proxy HTTP.

Liste des fichiers de configuration conservés, ainsi que des sections et des clés conservées

Voici la liste de tous les fichiers de configuration, ainsi que les sections et les clés qui sont automatiquement conservées pendant la mise à niveau de cu.

Remarque

Les atténuations des règles de réécriture d’URL IIS qui ont été appliquées au niveau par site/par vDir ne seront pas conservées par cette fonctionnalité et seront finalement réappliquées par le service d’atténuation des urgences Exchange si elles sont toujours applicables à la mise à jour cumulative installée. Vous trouverez plus d’informations ici.

Non.	Nom du fichier de configuration	Sections conservées	Clés supplémentaires conservées
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

Une fois l’installation terminée, les messages suivants s’affichent pour indiquer que tous les paramètres de configuration conservés ont été correctement restaurés.

Mode GUI

Mode sans assistance

La sauvegarde des fichiers de configuration conservés est stockée dans %ProgramFiles%\Microsoft\Exchange Server\V15\Config des sous-dossiers qui utilisent un format de nommage de v_<ExchangeVersion>_<Timestamp>.

Remarque

Si ces fichiers ne sont pas nécessaires une fois l’installation terminée, ils peuvent être supprimés en toute sécurité.

Le programme d’installation conserve les paramètres personnalisés par défaut. Si vous ne souhaitez pas utiliser cette fonctionnalité, vous pouvez la désactiver en créant une REG_SZ entrée DisablePreservation sous HKLM\SOFTWARE\Microsoft\ExchangeServer\v15\Setup et en définissant la valeur sur 1.

La paire clé/valeur peut être créée en exécutant la commande PowerShell suivante :

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

Si le programme d’installation d’Exchange est exécuté après avoir défini la clé d’inscription sur 1, le programme d’installation ne sauvegarde ni ne restaure aucune paire clé/valeur dans l’une des configurations.

Clé de registre	Valeur de Registre	Comportement de la configuration d’Exchange
DisablePreservation (Type : REG_SZ)	1	Toutes les paires clé-valeur dans les fichiers de configuration sont réinitialisées et aucune sauvegarde de la configuration de pré-mise à niveau n’est stockée (ce comportement équivaut aux mises à niveau cu précédentes).
DisablePreservation (Type : REG_SZ)	NULL	Le programme d’installation crée une sauvegarde des configurations de pré-mise à niveau et conserve certaines paires clé/valeur dans les configurations de pré-mise à niveau vers les nouvelles configurations.
DisablePreservation (Type : REG_SZ)	Toute autre valeur	Le programme d’installation crée une sauvegarde des configurations de pré-mise à niveau et conserve certaines paires clé/valeur dans les configurations de pré-mise à niveau vers les nouvelles configurations.

Si le programme d’installation ne peut pas restaurer tous les paramètres à leur état précédent, il affiche un avertissement.

Mode sans assistance

Mode assisté

À l’étape suivante, les administrateurs peuvent analyser le fichier journal de l’installation pour voir quels paramètres n’ont pas pu être conservés. Une ou plusieurs entrées peuvent être présentes dans le fichier journal pour indiquer les paramètres qui n’ont pas pu être conservés :

1. Exception rencontrée lors de la lecture du fichier de configuration : <configFileName>. Ignorer la conservation.
2. Exception rencontrée lors de l’enregistrement <Preservation cmdlet name> des modifications apportées à : <configFileName>.
3. Exception rencontrée lors de la validation du schéma du fichier de configuration : <configFileName>. Ignorer la conservation.
4. <Preservation cmdlet name> échec pour : <configFileName>

Les administrateurs peuvent copier manuellement tous les fichiers de configuration de l’emplacement de sauvegarde vers l’emplacement requis en remplaçant les fichiers créés par le programme d’installation. Cela restaure également ces fichiers à leur état de pré-installation.