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.

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>.

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.

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.