Conservation de la configuration personnalisée d’Exchange Server

S’APPLIQUE À :2016 2019 Édition d’abonnement

Vue d’ensemble

Après avoir installé Exchange Server, une tâche d’administration courante consiste à personnaliser les paramètres, tels que les limites de taille de message 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 Exchange Server est que chaque fois qu’une mise à jour cumulative (CU) est installée, ces fichiers et les paramètres personnalisés qu’ils contiennent sont remplacés par le programme d’installation, ce qui oblige un administrateur à sauvegarder/restaurer ses paramètres ou à les réappliquer après chaque installation 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’aient 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 un serveur Exchange Server existant) et remplace les fichiers existants avec 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 antérieurs à la 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 de <add key> la balise est conservée si cette section est présente.

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

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

2. Toute la proxySettings section est critique et est préservée.

3. maxAllowedContentLength est utilisé pour spécifier la longueur maximale du contenu (en octets) d’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 demande.

   <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 deux systembinding éléments et customBinding et est utilisé pour limiter la taille de chaîne maximale renvoyé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 client 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és pendant la mise à niveau de la mise à niveau de la mise à jour

Une fois l’installation terminée, il affiche les messages suivants pour indiquer que tous les paramètres de configuration conservés ont été restaurés avec succè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>.

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 Exchange est exécuté après avoir défini la clé de registre sur 1, le programme d’installation ne sauvegardera ni ne restaurera aucune paire clé/valeur dans aucune des 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é

Dans l’étape suivante, les administrateurs peuvent analyser le fichier journal d’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> a échoué 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 antérieur à l’installation.