ConfigurationHistorySection 类
配置 ApplicationHost 帮助程序服务的配置历史记录设置。
语法
class ConfigurationHistorySection : ConfigurationSection
方法
下表列出了 ConfigurationHistorySection 类公开的方法。
| 名称 | 描述 |
|---|---|
| GetAllowDefinition | （继承自 ConfigurationSection。） |
| GetAllowLocation | （从 ConfigurationSection 继承。） |
| RevertToParent | （从 ConfigurationSection 继承。） |
| SetAllowDefinition | （从 ConfigurationSection 继承。） |
| SetAllowLocation | （从 ConfigurationSection 继承。） |
属性
下表列出了 ConfigurationHistorySection 类公开的属性。
| 名称 | 描述 |
|---|---|
Enabled |
一个读/写 boolean 值。 如果 ApplicationHost Helper Service 使用 Period 属性指定的时间间隔检查 ApplicationHost.config 文件中的更改，则为 true；如果该服务不检查更改，则为 false。 默认为 true。 如果配置发生更改且仍然有效，帮助程序服务会将 ApplicationHost.config 文件保存到 HistoryPath 属性所指定的目录内的已版本控制的子目录。 |
HistoryPath |
一个读/写 string 值，该值指定包含配置历史记录子目录的目录路径。 默认值为“%systemdrive%\inetpub\history”。 注意：ApplicationHost Helper Service 在每个配置历史记录子目录中保存一份 ApplicationHost.config 文件副本。 配置历史记录子目录的命名格式为 CFGHISTORY_<序列号>。 序列号是 10 位连续数字（以零填充）。 |
Location |
（继承自 ConfigurationSection。）一个键属性。 |
MaxHistories |
一个读/写 uint32 值，该值指定配置历史记录子目录的最大数量。 默认值为 10。 如果配置历史子目录的数量达到指定数量，则删除版本号最小的子目录。 |
Path |
（继承自 ConfigurationSection。）一个键属性。 |
Period |
一个读/写 datetime 值，该值指定 ApplicationHost Helper Service 检查 ApplicationHost.config 文件中的更改的频率。 默认值为 2 分钟。 如果配置发生更改且仍然有效，帮助程序服务会将文件保存到 HistoryPath 属性指定的目录。 |
SectionInformation |
（从 ConfigurationSection 继承。） |
子类
此类不包含子类。
注解
此类提供配置历史记录功能，使用该功能可在不再需要当前状态时恢复为先前的配置状态。
ApplicationHost Helper Service 通过保存 ApplicationHost.config 文件来启用配置历史记录功能，配置历史记录子目录按 Period 属性指定的设定时间间隔进行分隔。 子目录位于 HistoryPath 属性指定的目录。
如果修改 ApplicationHost.config 文件时出错，可通过将早期版本复制到 %windir%\system32\inetsrv\config 目录中，从配置历史记录子目录中还原该文件的早期版本。
注意
配置历史记录文件不需要单独的访问控制列表 (ACL) 配置。 它们从父目录继承 ACL 值，只有管理员才能访问该父目录。
配置历史记录功能依赖于 ApplicationHost Helper Service。 ApplicationHost Helper Service 是一项独立于运行时的服务，无需 Windows Process Activation Service (WAS) 或万维网发布服务（WWW 服务）即可运行。 它不依赖于任何其他服务，且启动类型为 Automatic。
注意
如果停用 ApplicationHost Helper Service，配置历史记录功能将无法正常运行。
示例
以下代码示例将历史记录子目录的最大数量设为 20，并指定每 4 分钟检查一次 ApplicationHost.config 文件是否有更改。 帮助程序函数显示更改前后的 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
要求
| 类型 | 描述 |
|---|---|
| 客户端 | - 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 |