Класс ConfigurationHistorySection

Статья
07/19/2023

Настраивает параметры журнала конфигурации вспомогательной службы ApplicationHost.

Синтаксис

class ConfigurationHistorySection : ConfigurationSection

Методы

В следующей таблице перечислены методы, предоставляемые классом ConfigurationHistorySection .

Имя	Описание
GetAllowDefinition	(Наследуется от ConfigurationSection.)
GetAllowLocation	(Является наследником `ConfigurationSection`)
RevertToParent	(Является наследником `ConfigurationSection`)
SetAllowDefinition	(Является наследником `ConfigurationSection`)
SetAllowLocation	(Является наследником `ConfigurationSection`)

Свойства

В следующей таблице перечислены свойства, предоставляемые классом ConfigurationHistorySection .

Имя	Описание
`Enabled`	Значение для чтения и записи `boolean` . `true`Значение , если вспомогатель ApplicationHost проверяет наличие изменений в файле ApplicationHost.config с помощью интервала времени, заданного `Period` свойством ; значение , `false` если служба не проверка изменений. Значение по умолчанию — `true`. Если конфигурация изменяется и по-прежнему действительна, вспомогательная служба сохраняет файл ApplicationHost.config в подкаталоге с управлением версиями в каталоге, указанном свойством `HistoryPath` .
`HistoryPath`	Значение для чтения и записи `string` , указывающее путь к каталогу, содержашему подкаталоги журнала конфигурации. Значение по умолчанию — "%systemdrive%\inetpub\history". Примечание: Вспомогательную службу ApplicationHost сохраняет одну копию файла ApplicationHost.config в каждом подкаталоге журнала конфигурации. Подкаталоги журнала конфигурации имеют формат именования CFGHISTORY_<сериальный номер>. Серийный номер — это 10-значное последовательное число (с нулевым заполнением).
`Location`	(Наследуется от `ConfigurationSection`.) Свойство ключа.
`MaxHistories`	Значение для чтения и записи `uint32` , указывающее максимальное количество подкаталогов журнала конфигурации. Значение по умолчанию равно 10. Если количество подкаталогов журнала конфигурации достигает указанного числа, подкаталог с наименьшим номером версии удаляется.
`Path`	(Наследуется от `ConfigurationSection`.) Свойство ключа.
`Period`	Значение для чтения и записи `datetime` , указывающее частоту, с которой вспомогающая служба ApplicationHost проверяет изменения в файле ApplicationHost.config. По умолчанию используется значение 2 минут. Если конфигурация изменяется и по-прежнему действительна, вспомогательная служба сохраняет файлы в каталоге, указанном свойством `HistoryPath` .
`SectionInformation`	(Является наследником `ConfigurationSection`)

используются подклассы ;

Этот класс не содержит подклассов.

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

Если вы допустили ошибку при изменении файла ApplicationHost.config, вы можете восстановить более раннюю версию файла из подкаталога журнала конфигурации, скопировав более раннюю версию в каталог %windir%\system32\inetsrv\config.

Примечание

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

Функция журнала конфигурации зависит от вспомогательной службы ApplicationHost. Вспомогающая служба ApplicationHost — это независимая от среды выполнения служба, для работы которой не требуется служба активации процессов Windows (WAS) или служба веб-публикации (служба WWW). Он не зависит от какой-либо другой службы, и его тип запуска — Automatic.

Примечание

Если вспомогатель ApplicationHost остановлена, функция журнала конфигурации не будет работать.

Пример

В следующем примере кода задается максимальное число подкаталогов журнала 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

Иерархия наследования

ConfigurationSection

ConfigurationHistorySection

Требования

Тип	Описание
клиент	— IIS 7.0 в Windows Vista — IIS 7.5 в Windows 7 — IIS 8.0 в Windows 8 — IIS 10.0 в Windows 10
Сервер	— IIS 7.0 в Windows Server 2008 — IIS 7.5 в Windows Server 2008 R2 — IIS 8.0 в Windows Server 2012 — IIS 8.5 в Windows Server 2012 R2 — IIS 10.0 в Windows Server 2016
Продукт	— IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0
MOF-файл	WebAdministration.mof

См. также:

Класс ConfigurationSection

Поделиться через