ConfigurationHistorySection 클래스
ApplicationHost 도우미 서비스의 구성 기록 설정을 구성합니다.
구문
class ConfigurationHistorySection : ConfigurationSection
메서드
다음 표에서는 클래스에서 노출하는 메서드를 나열합니다 ConfigurationHistorySection .
| 속성 | Description |
|---|---|
| GetAllowDefinition | ( ConfigurationSection에서 상속됩니다.) |
| GetAllowLocation | ConfigurationSection에서 상속됩니다. |
| RevertToParent | ConfigurationSection에서 상속됩니다. |
| SetAllowDefinition | ConfigurationSection에서 상속됩니다. |
| SetAllowLocation | ConfigurationSection에서 상속됩니다. |
속성
다음 표에서는 클래스에서 노출하는 속성을 나열합니다 ConfigurationHistorySection .
| 속성 | Description |
|---|---|
Enabled |
읽기/쓰기 boolean 값입니다. trueApplicationHost Helper Service가 속성에 지정된 시간 간격을 사용하여 ApplicationHost.config 파일의 Period 변경 내용을 확인하면 이고, false 서비스가 변경 내용을 검사 않는 경우 입니다. 기본값은 true입니다. 구성이 변경되고 여전히 유효한 경우 도우미 서비스는 속성에 지정된 HistoryPath 디렉터리 내 버전이 지정된 하위 디렉터리에 ApplicationHost.config 파일을 저장합니다. |
HistoryPath |
구성 기록 하위 디렉터리가 포함된 디렉터리의 경로를 지정하는 읽기/쓰기 string 값입니다. 기본값은 "%systemdrive%\inetpub\history"입니다. 참고: ApplicationHost Helper Service는 각 구성 기록 하위 디렉터리에 ApplicationHost.config 파일의 복사본 하나를 저장합니다. 구성 기록 하위 디렉터리에는 명명 형식 CFGHISTORY_<serial number>가 있습니다. 일련 번호는 10자리 순차 번호(패딩 0개)입니다. |
Location |
(에서 ConfigurationSection상속됨) 키 속성입니다. |
MaxHistories |
구성 기록 하위 디렉터리의 최대 수를 지정하는 읽기/쓰기 uint32 값입니다. 기본값은 10입니다. 구성 기록 하위 디렉터리 수가 지정된 수에 도달하면 버전 번호가 가장 낮은 하위 디렉터리가 삭제됩니다. |
Path |
(에서 ConfigurationSection상속됨) 키 속성입니다. |
Period |
ApplicationHost 도우미 서비스에서 ApplicationHost.config 파일의 변경 내용을 확인하는 빈도를 지정하는 읽기/쓰기 datetime 값입니다. 기본값은 2분입니다. 구성이 변경되고 여전히 유효한 경우 도우미 서비스는 속성에 지정된 HistoryPath 디렉터리에 파일을 저장합니다. |
SectionInformation |
ConfigurationSection에서 상속됩니다. |
를 서브클래싱합니다.
이 클래스에는 하위 클래스가 없습니다.
설명
이 클래스는 현재 상태를 더 이상 원하지 않는 경우 이전 구성 상태로 돌아갈 수 있는 구성 기록 기능을 제공합니다.
ApplicationHost 도우미 서비스를 사용하면 속성에 지정된 Period 설정된 간격으로 구성 기록 하위 디렉터리를 구분하기 위해 ApplicationHost.config 파일을 저장하여 구성 기록 기능을 사용할 수 있습니다. 하위 디렉터리가 속성에 지정된 HistoryPath 디렉터리에 있습니다.
ApplicationHost.config 파일을 수정할 때 오류가 발생하는 경우 이전 버전을 %windir%\system32\inetsrv\config 디렉터리에 복사하여 구성 기록 하위 디렉터리에서 이전 버전의 파일을 복원할 수 있습니다.
참고
구성 기록 파일에는 별도의 ACL(액세스 제어 목록) 구성이 필요하지 않습니다. 관리자만 액세스할 수 있는 부모 디렉터리에서 ACL 값을 상속합니다.
구성 기록 기능은 ApplicationHost 도우미 서비스에 따라 달라집니다. ApplicationHost 도우미 서비스는 WAS(Windows Process Activation Service) 또는 WWW 서비스(World Wide Web Publishing Service)가 작동하지 않아도 되는 런타임 독립적 서비스입니다. 다른 서비스에 의존하지 않으며 해당 시작 유형은 입니다 Automatic.
참고
ApplicationHost 도우미 서비스가 중지되면 구성 기록 기능이 작동하지 않습니다.
예제
다음 코드 예제에서는 기록 하위 디렉터리의 maxiumum 수를 20으로 설정하고 ApplicationHost.config 파일에서 4분마다 변경 내용을 확인하도록 지정합니다. 도우미 함수는 변경 전후의 ConfigurationHistorySection 값을 표시합니다.
' Connect to the WMI WebAdministration namespace.
Set oWebAdmin = GetObject("winmgmts:root\WebAdministration")
' Get the configuration history section.
Set oSection = oWebAdmin.Get( _
"ConfigurationHistorySection.Path=" & _
"'MACHINE/WEBROOT/APPHOST',Location=''")
' Display the class name of the section.
WScript.Echo "[ " & oSection.Path_.Class & " ]" & vbCrLf
' Display the initial settings.
Call DisplaySettings("Initial Values", oSection)
' Set the maximum number of history subdirectories to 20.
oSection.MaxHistories = 20
' Check ApplicationHost.config for changes every 4 minutes.
oSection.Period = "00000000000400.000000:000"
' Save the values to configuration.
oSection.Put_
' Refresh the oSection object variable with the new values.
oSection.Refresh_
' Show the changed settings.
Call DisplaySettings("New Values", oSection)
' ==== DisplaySettings helper function. ====
Function DisplaySettings(HeadingText, oSection)
' Display a heading.
WScript.Echo String(Len(HeadingText), "-")
WScript.Echo HeadingText
WScript.Echo String(Len(HeadingText), "-")
' Display configuration history section properties.
WScript.Echo "Path: " & oSection.Path
WScript.Echo "Location: " & oSection.Location
WScript.Echo "History Path: " & oSection.HistoryPath
WScript.Echo "Period: " & oSection.Period
WScript.Echo "MaxHistories: " & oSection.MaxHistories
WScript.Echo
End Function
상속 계층 구조
ConfigurationHistorySection
요구 사항
| 형식 | Description |
|---|---|
| 클라이언트 | - Windows Vista의 IIS 7.0 - Windows 7의 IIS 7.5 - Windows 8의 IIS 8.0 - WINDOWS 10 IIS 10.0 |
| 서버 | - Windows Server 2008의 IIS 7.0 - Windows Server 2008 R2의 IIS 7.5 - Windows Server 2012의 IIS 8.0 - Windows Server 2012 R2의 IIS 8.5 - WINDOWS SERVER 2016 IIS 10.0 |
| 제품 | - IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0 |
| MOF 파일 | WebAdministration.mof |