Classe ConfigurationHistorySection

Article
03/19/2024

Configure les paramètres d’historique de configuration du service ApplicationHost Helper.

Syntaxe

class ConfigurationHistorySection : ConfigurationSection

Méthodes

Le tableau suivant répertorie les méthodes exposées par la classe ConfigurationHistorySection.

Nom	Description
GetAllowDefinition	(Hérité de ConfigurationSection.)
GetAllowLocation	(Hérité de `ConfigurationSection`.)
RevertToParent	(Hérité de `ConfigurationSection`.)
SetAllowDefinition	(Hérité de `ConfigurationSection`.)
SetAllowLocation	(Hérité de `ConfigurationSection`.)

Propriétés

Le tableau suivant répertorie les propriétés exposées par la classe ConfigurationHistorySection.

Nom	Description
`Enabled`	Une valeur `boolean` en lecture/écriture. `true` si le service ApplicationHost Helper vérifie les modifications apportées au fichier ApplicationHost.config à l’aide de l’intervalle de temps spécifié par la propriété `Period` ; `false` si le service ne vérifie pas les modifications. Par défaut, il s’agit de `true`. Si la configuration change et est toujours valide, le service d’assistance enregistre le fichier ApplicationHost.config dans un sous-répertoire versionné dans le répertoire spécifié par la propriété `HistoryPath`.
`HistoryPath`	Valeur de `string` en lecture/écriture qui spécifie le chemin d’accès du répertoire qui contient les sous-répertoires de l’historique de configuration. La valeur par défaut est «%systemdrive%\inetpub\history ». Remarque : Le service ApplicationHost Helper enregistre une copie du fichier ApplicationHost.config dans chaque sous-répertoire de l’historique de configuration. Les sous-répertoires de l’historique de configuration ont le format de nommage CFGHISTORY_<serial number>. Le numéro de série est un nombre séquentiel à 10 chiffres (à remplissage de zéros).
`Location`	(Hérité de `ConfigurationSection`.) Une propriété clé.
`MaxHistories`	Valeur de `uint32` en lecture/écriture qui spécifie le nombre maximal de sous-répertoires de l’historique de configuration. La valeur par défaut est de 10. Si le nombre de sous-répertoires de l’historique de configuration atteint le nombre spécifié, le sous-répertoire avec le numéro de version le plus bas est supprimé.
`Path`	(Hérité de `ConfigurationSection`.) Une propriété clé.
`Period`	Valeur de `datetime` en lecture/écriture qui spécifie la fréquence avec laquelle le service ApplicationHost Helper vérifie les modifications apportées au fichier ApplicationHost.config. La valeur par défaut est 2 (minutes). Si la configuration change et est toujours valide, le service d’assistance enregistre les fichiers dans le répertoire spécifié par la propriété `HistoryPath`.
`SectionInformation`	(Hérité de `ConfigurationSection`.)

Sous-classes

Cette classe ne contient aucune sous-classe.

Notes

Cette classe fournit une fonctionnalité d’historique de configuration qui vous permet de revenir à un ancien état de configuration si vous ne souhaitez plus l’état actuel.

Le service ApplicationHost Helper active la fonctionnalité d’historique de configuration en enregistrant le fichier ApplicationHost.config pour séparer les sous-répertoires de l’historique de configuration à des intervalles définis spécifiés par la propriété Period. Les sous-répertoires résident dans le répertoire spécifié par la propriété HistoryPath.

Si par exemple vous faites une erreur lorsque vous modifiez le fichier ApplicationHost.config, vous pouvez restaurer une version antérieure du fichier à partir d’un sous-répertoire d’historique de configuration en copiant la version antérieure dans le répertoire %windir%\system32\inetsrv\config.

Remarque

Les fichiers d’historique de configuration ne nécessitent pas de configuration de liste de contrôle d’accès (ACL) distincte. Ils héritent de leurs valeurs de liste de contrôle d’accès à partir du répertoire parent, auquel seuls les administrateurs ont accès.

La fonctionnalité d’historique de configuration dépend du service ApplicationHost Helper. Le service ApplicationHost Helper est un service indépendant du runtime qui ne nécessite pas le fonctionnement du service d’activation de processus Windows (WAS) ou du service WWW (World Wide Web Publishing Service). Il ne dépend d’aucun autre service et son type de démarrage est Automatic.

Remarque

Si le service ApplicationHost Helper est arrêté, la fonctionnalité d’historique de configuration ne fonctionnera pas.

Exemple

L’exemple de code suivant définit le nombre maximal de sous-répertoires d’historique à 20 et spécifie que le fichier ApplicationHost.config doit être vérifié toutes les 4 minutes. Une fonction d’assistance affiche les valeurs ConfigurationHistorySection avant et après la modification.

' 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

Hiérarchie d'héritage

ConfigurationSection

ConfigurationHistorySection

Spécifications

Type	Description
Client	- IIS 7.0 sur Windows Vista - IIS 7.5 sur Windows 7 - IIS 8.0 sur Windows 8 - IIS 10.0 sur Windows 10
Serveur	- IIS 7.0 sur Windows Server 2008 - IIS 7.5 sur Windows Server 2008 R2 - IIS 8.0 sur Windows Server 2012 - IIS 8.5 sur Windows Server 2012 R2 - IIS 10.0 sur Windows Server 2016
Produit	- IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0
Fichier MOF	WebAdministration.mof

Voir aussi

Classe ConfigurationSection

Partager via