사용자 지정 구성 보존 Exchange Server
개요
Exchange Server 설치한 후 일반적인 관리자 작업은 클라이언트별 메시지 크기 제한과 같은 설정을 사용자 지정하는 것입니다. 이러한 설정은 일반적으로 Exchange 서버의 web.config, sharedweb.config및 기타 구성 파일에서 구성됩니다.
지금까지 Exchange 서버 관리자의 과제 중 하나는 CU(누적 업데이트)가 설치될 때마다 설치 프로그램에서 이러한 파일과 사용자 지정 설정을 덮어쓰고 관리자가 설정을 백업/복원하도록 강요하거나 CU를 설치할 때마다 다시 적용한다는 것입니다.
Exchange Server 2019 CU13 이상에서는 관리자가 더 이상 수동으로 복원하거나 다시 적용할 필요가 없도록 설치 프로그램에서 가장 일반적인 구성 파일을 백업하고 복원합니다.
설치 프로그램은 다음과 같은 방법으로 사용자 지정 구성을 유지합니다.
- 설치 프로그램은 기존 파일의 백업을 만듭니다.
- 설치 프로그램은 Exchange Server 설치(또는 기존 Exchange Server 업그레이드)하고 Exchange 설치 프로그램에 있는 기본 구성 및 설정으로 기존 파일을 덮어씁니다.
- 설치 프로그램은 마지막으로 Exchange 설치 프로그램에서 복사한 새 구성 파일의 사전 업그레이드 구성 파일에 저장된 중요한 키의 적절한 파일 및 사용자 지정 값을 복원합니다.
설치 프로그램은 전체 섹션 또는 특정 키 값 쌍을 포함할 수 있는 가장 중요한 구성 설정(있는 경우)을 유지합니다.
appSettings에는 애플리케이션 설정 범위(예: 로깅 경로, 메시지 큐 크기 등)를 구성하는 많은 키 값 쌍이 포함되어 있습니다. 태그를 사용하여<add key>만든 키 값 쌍은 이 섹션이 있는 경우 유지됩니다.예를 들어 다음 파일에서 는
ClientTunnelExpirationTime유지됩니다.<configuration> <appSettings> <add key="ClientTunnelExpirationTime" value="30" /> </appSettings> </ configuration>전체
proxySettings섹션은 중요하며 유지됩니다.maxAllowedContentLength는 요청에서 최대 콘텐츠 길이(바이트)를 지정하는 데 사용됩니다.<system.webServer> <security> <requestFiltering> <requestLimits maxAllowedContentLength="4194304" /> </requestFiltering> </security> <system.webServer>maxRequestLength는 최대 요청 크기를 지정하는 데 사용됩니다.<system.web> <httpRuntime maxRequestLength="4194304" /> </system.web>maxReceivedMessageSize는 및custombinding요소에서systembinding이 바인딩으로 구성된 채널에서 수신할 수 있는 메시지의 최대 크기(바이트)를 설정하는 데 사용됩니다.maxStringContentLength는 및customBinding요소 모두systembinding에 있으며 XML 판독기가 반환하는 최대 문자열 크기를 제한하는 데 사용됩니다.extendedProtectionPolicy는 서버에서 들어오는 클라이언트 연결의 유효성을 검사하는 데 사용되는 확장된 보호 정책을 설정하는 데 사용됩니다.defaultProxy는 HTTP 프록시 서버를 구성하는 데 사용됩니다.
유지되는 섹션 및 키와 함께 보존된 구성 파일 목록
CU 업그레이드 중에 자동으로 유지되는 섹션 및 키와 함께 모든 구성 파일의 목록은 다음과 같습니다.
참고
사이트별/vDir별 수준에 적용된 IIS URL 다시 쓰기 규칙 완화는 이 기능에 의해 유지되지 않으며, 설치된 CU에 계속 적용할 수 있는 경우 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 |
설치가 완료되면 보존된 모든 구성 설정이 성공적으로 복원되었음을 나타내는 다음 메시지가 표시됩니다.
GUI 모드
무인 모드
보존된 구성 파일의 백업은 의 명명 형식v_<ExchangeVersion>_<Timestamp>을 사용하는 하위 폴더에 저장 %ProgramFiles%\Microsoft\Exchange Server\V15\Config 됩니다.
참고
설치가 완료된 후 이러한 파일이 필요하지 않은 경우 안전하게 삭제할 수 있습니다.
설치 프로그램은 기본적으로 사용자 지정 설정을 유지합니다. 이 기능을 사용하지 않으려면 아래에 HKLM\SOFTWARE\Microsoft\ExchangeServer\v15\Setup 항목을 DisablePreservation 만들고 REG_SZ 값을 1로 설정하여 사용하지 않도록 설정할 수 있습니다.
다음 PowerShell 명령을 실행하여 키/값 쌍을 만들 수 있습니다.
New-ItemProperty -Path HKLM:\SOFTWARE\Microsoft\ExchangeServer\v15\Setup -Name "DisablePreservation" -Value 1 -Type String
Regkey 1를 로 설정한 후 Exchange 설치 프로그램을 실행하는 경우 설정은 구성에서 키/값 쌍을 백업하거나 복원하지 않습니다.
| 레지스트리 키 | 레지스트리 값 | Exchange 설정 동작 |
|---|---|---|
DisablePreservation(형식: REG_SZ) |
1 | 구성 파일의 모든 키 값 쌍이 다시 설정되고 사전 업그레이드 구성의 백업이 저장되지 않습니다(이 동작은 이전 CU 업그레이드와 동일). |
DisablePreservation(형식: REG_SZ) |
NULL | 설치 프로그램은 사전 업그레이드 구성의 백업을 만들고 새 구성에 대한 사전 업그레이드 구성에서 특정 키/값 쌍을 유지합니다. |
DisablePreservation(형식: REG_SZ) |
기타 모든 값 | 설치 프로그램은 사전 업그레이드 구성의 백업을 만들고 새 구성에 대한 사전 업그레이드 구성에서 특정 키/값 쌍을 유지합니다. |
설치 프로그램이 모든 설정을 이전 상태로 복원할 수 없는 경우 경고가 표시됩니다.
무인 모드
참가 모드
다음 단계로 관리자는 설치 로그 파일을 분석하여 보존할 수 없는 설정을 확인할 수 있습니다. 보존할 수 없는 설정을 나타내기 위해 로그 파일에 하나 이상의 항목이 있을 수 있습니다.
- 구성 파일을 읽는 동안 예외가
<configFileName>발생했습니다. 보존 건너뛰기. - 변경 내용을 저장하는
<Preservation cmdlet name>동안 예외가<configFileName>발생했습니다. - 구성 파일의 스키마 유효성 검사 중에 예외가
<configFileName>발생했습니다. 보존 건너뛰기. <Preservation cmdlet name>다음을 수행하지 못했습니다.<configFileName>
관리자는 설치 프로그램에서 만든 파일을 덮어써서 백업 위치에서 필요한 위치로 구성 파일을 수동으로 복사할 수 있습니다. 또한 이러한 파일은 사전 설정 상태로 복원됩니다.