Compartir a través de

Clase ConfigurationHistorySection

  • Artículo

Configura los valores del historial de configuración del servicio auxiliar ApplicationHost.

Sintaxis

class ConfigurationHistorySection : ConfigurationSection

Métodos

La siguiente tabla muestra los métodos expuestos por la clase ConfigurationHistorySection.

Nombre Descripción
GetAllowDefinition (Se hereda de ConfigurationSection).
GetAllowLocation (Se hereda de ConfigurationSection).
RevertToParent (Se hereda de ConfigurationSection).
SetAllowDefinition (Se hereda de ConfigurationSection).
SetAllowLocation (Se hereda de ConfigurationSection).

Propiedades

La siguiente tabla enumera las propiedades expuestas por la clase ConfigurationHistorySection.

Nombre Descripción
Enabled Valor boolean de lectura y escritura. true si el servicio auxiliar de ApplicationHost comprueba si hay cambios en el archivo ApplicationHost.config mediante el intervalo de tiempo que especifica la propiedad Period; false si el servicio no comprueba si hay cambios. El valor predeterminado es true. Si la configuración cambia y sigue siendo válida, el servicio auxiliar guarda el archivo ApplicationHost.config en un subdirectorio con versiones dentro del directorio que especifica la propiedad HistoryPath.
HistoryPath Un valor string de lectura y escritura que especifica la ruta de acceso del directorio que contiene los subdirectorios del historial de configuración. El valor predeterminado es "%systemdrive%\inetpub\history". Nota: El servicio auxiliar ApplicationHost guarda una copia del archivo ApplicationHost.config en cada subdirectorio del historial de configuración. Los subdirectorios del historial de configuración tienen el formato de nomenclatura CFGHISTORY_<número de serie>. El número de serie es un número secuencial de 10 dígitos (rellenado con ceros).
Location (Se hereda de ConfigurationSection). Una propiedad clave.
MaxHistories Un valor uint32 de lectura y escritura que especifica el número máximo de subdirectorios del historial de configuración. El valor predeterminado es 10. Si el número de subdirectorios del historial de configuración alcanza el número especificado, se elimina el subdirectorio con el número de versión más bajo.
Path (Se hereda de ConfigurationSection). Una propiedad clave.
Period Un valor datetime de lectura y escritura que especifica la frecuencia con la que el servicio auxiliar ApplicationHost comprueba si hay cambios en el archivo ApplicationHost.config. El valor predeterminado es 2 minutos. Si la configuración cambia y sigue siendo válida, el servicio auxiliar guarda los archivos en el directorio que especifica la propiedad HistoryPath.
SectionInformation (Se hereda de ConfigurationSection).

Subclases

Esta clase no contiene subclases.

Comentarios

Esta clase proporciona una característica del historial de configuración que permite volver a un estado de configuración anterior si ya no quiere el estado actual.

El servicio auxiliar ApplicationHost habilita la función del historial de configuración guardando el archivo ApplicationHost.config para separar los subdirectorios del historial de configuración a intervalos establecidos y que especifica la propiedad Period. Los subdirectorios residen en el directorio que especifica la propiedad HistoryPath.

Si comete un error al modificar el archivo ApplicationHost.config, puede restaurar una versión anterior del archivo desde un subdirectorio del historial de configuración copiando la versión anterior en el directorio %windir%\system32\inetsrv\config.

Nota:

Los archivos del historial de configuración no requieren una configuración independiente de la lista de control de acceso (ACL). Heredan sus valores de ACL del directorio primario, al que solo los administradores tienen acceso.

La característica del historial de configuración depende del servicio auxiliar ApplicationHost. El servicio auxiliar ApplicationHost es un servicio independiente del runtime que no necesita el servicio de activación de procesos de Windows (WAS) ni el servicio de publicación World Wide Web (servicio WWW) para funcionar. No depende de ningún otro servicio y su tipo de inicio es Automatic.

Nota:

Si se detiene el servicio auxiliar ApplicationHost, la característica del historial de configuración no funcionará.

Ejemplo

En el ejemplo de código siguiente se establece el número máximo de subdirectorios de historial en 20 y se especifica que el archivo ApplicationHost.config se comprobará cada 4 minutos en busca de cambios. Una función auxiliar muestra los valores ConfigurationHistorySection antes y después del cambio.

' 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

Jerarquía de herencia

ConfigurationSection

ConfigurationHistorySection

Requisitos

Tipo Descripción
Remoto - IIS 7.0 en Windows Vista
- IIS 7.5 en Windows 7
- IIS 8.0 en Windows 8
- IIS 10.0 en Windows 10
Server - IIS 7.0 en Windows Server 2008
- IIS 7.5 en Windows Server 2008 R2
- IIS 8.0 en Windows Server 2012
- IIS 8.5 en Windows Server 2012 R2
- IIS 10.0 en Windows Server 2016
Producto - IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0
Archivo MOF WebAdministration.mof

Consulte también

Clase ConfigurationSection