сохранение пользовательской конфигурации Exchange Server

Обзор

После установки Exchange Server обычной задачей администратора является настройка параметров, таких как ограничения на размер сообщений клиента. Эти параметры обычно настраиваются в web.config, sharedweb.configи других файлах конфигурации на сервере Exchange Server.

Сложилось так, что одна из проблем для администраторов Exchange Server заключается в том, что при каждой установке накопительного обновления эти файлы и пользовательские параметры в них перезаписываются программой установки, заставляя администратора создавать резервные копии или восстанавливать их или повторно применить их после каждой установки cu.

При использовании Exchange Server 2019 CU13 и более поздних версий программа установки теперь выполняет резервное копирование и восстановление наиболее распространенных файлов конфигурации, чтобы администраторам больше не нужно восстанавливать их вручную или повторно применить их.

Программа установки сохраняет пользовательские конфигурации следующим образом:

1. Программа установки создает резервную копию существующих файлов.
2. Программа установки устанавливает Exchange Server (или обновляет существующие Exchange Server), а существующие файлы перезаписываются конфигурациями и параметрами по умолчанию, присутствующими в программе установки Exchange.
3. Программа установки окончательно восстанавливает соответствующие файлы и пользовательские значения критических ключей, хранящихся в файлах конфигурации preupgrade в новых файлах конфигурации, скопированных из программы установки Exchange.

Программа установки сохраняет наиболее важные параметры конфигурации (если они есть), которые могут включать целые разделы или определенные пары значений ключей.

1. appSettings содержит много пар ключевых значений, которые настраивают диапазон параметров приложения (например, путь ведения журнала, размер очереди сообщений и т. д.). Любая пара значений ключей, созданная с помощью <add key> тега, сохраняется, если этот раздел присутствует.

   Например, в следующем файле ClientTunnelExpirationTime сохраняется.

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

2. Весь proxySettings раздел является критическим и сохраняется.

3. maxAllowedContentLength используется для указания максимальной длины содержимого (в байтах) в запросе.

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

4. maxRequestLength используется для указания максимального размера запроса.

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

5. maxReceivedMessageSize используется в systembinding элементах и custombinding для задания максимального размера (в байтах) для сообщения, которое может быть получено в канале, настроенном с помощью этой привязки.

6. maxStringContentLength присутствует в элементах systembinding и и customBinding используется для ограничения максимального размера строки, возвращаемого средством чтения XML.

7. extendedProtectionPolicy используется для установки политики расширенной защиты, которая используется сервером для проверки входящих клиентских подключений.

8. defaultProxy используется для настройки прокси-сервера HTTP.

Список сохраненных файлов конфигурации вместе с разделами и ключами, сохраненными

Ниже приведен список всех файлов конфигурации, а также разделов и ключей, которые автоматически сохраняются во время обновления CU.

Примечание.

Устранение рисков правил перезаписи URL-адресов IIS, примененных на уровне каждого сайта или каждого виртуального каталога, не будет сохранено этой функцией и в конечном итоге будет повторно применено службой экстренного устранения рисков Exchange, если они по-прежнему применимы для установленного накопительного пакета обновления. Дополнительные сведения см. здесь.

Нет.	Имя файла конфигурации	Разделы, сохраненные	Дополнительные ключи, сохраненные
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

После завершения установки будут отображаться следующие сообщения, указывающие на успешное восстановление всех сохраненных параметров конфигурации.

Режим графического пользовательского интерфейса

Автоматический режим

Резервная копия сохраненных файлов конфигурации хранится во %ProgramFiles%\Microsoft\Exchange Server\V15\Config вложенных папках, использующих формат именования v_<ExchangeVersion>_<Timestamp>.

Примечание.

Если эти файлы не требуются после завершения установки, их можно безопасно удалить.

Настройка сохраняет пользовательские параметры по умолчанию. Если вы не хотите использовать эту функцию, ее можно отключить, создав REG_SZ запись DisablePreservation в разделе HKLM\SOFTWARE\Microsoft\ExchangeServer\v15\Setup и задав для нее 1значение .

Пару "ключ-значение" можно создать, выполнив следующую команду PowerShell:

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

Если программа установки Exchange запускается после установки ключа regkey в 1, программа установки не будет выполнять резервное копирование и восстановление пары "ключ—значение" ни в одной из конфигураций.

Раздел реестра	Значение реестра	Поведение при настройке Exchange
DisablePreservation (Type: REG_SZ)	1	Все пары значений ключей в файлах конфигурации сбрасываются, и резервная копия конфигурации preupgrade не сохраняется (это поведение эквивалентно предыдущим обновлениям cu).
DisablePreservation (Type: REG_SZ)	NULL	Программа установки создает резервную копию конфигураций предварительной версии и сохраняет определенную пару "ключ— значение" в конфигурациях preupgrade в новых конфигурациях.
DisablePreservation (Type: REG_SZ)	Любое другое значение	Программа установки создает резервную копию конфигураций предварительной версии и сохраняет определенную пару "ключ— значение" в конфигурациях preupgrade в новых конфигурациях.

Если программа установки не может восстановить все параметры до предыдущего состояния, отобразится предупреждение.

Автоматический режим

Режим участников

В качестве следующего шага администраторы могут проанализировать файл журнала установки, чтобы узнать, какие параметры не удалось сохранить. В файле журнала может присутствовать одна или несколько записей, указывающих, какие параметры не удалось сохранить:

1. При чтении файла конфигурации возникло исключение: <configFileName>. Пропуск сохранения.
2. Исключение, обнаруженное при сохранении <Preservation cmdlet name> изменений в: <configFileName>.
3. При проверке схемы файла конфигурации возникло исключение: <configFileName>. Пропуск сохранения.
4. <Preservation cmdlet name> сбой для: <configFileName>

Администраторы могут вручную скопировать любые файлы конфигураций из расположения резервной копии в требуемое расположение, перезаписав файлы, созданные программой установки. Это также восстанавливает эти файлы до состояния, предшествующего установке.