Classe SectionInformation

Article
03/26/2024

Spécifie les paramètres de remplacement et de verrouillage de contrôle pour une section de configuration.

Syntaxe

class SectionInformation : EmbeddedObject

Méthodes

Cette classe ne contient pas de méthodes.

Propriétés

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

Nom	Description
`EffectiveOverrideMode`	Valeur en lecture seule `string` qui spécifie si la section de configuration actuelle peut remplacer efficacement ses paramètres hérités. Les valeurs possibles sont répertoriées plus loin dans la section Remarques. Pour déterminer la valeur de `EffectiveOverrideMode`, IIS traverse la hiérarchie d’héritage des sections de configuration de la section active. Il examine successivement la propriété `OverrideMode` de chaque section parente jusqu’à atteindre l’attribut `overrideModeDefault` dans la définition de schéma de section. IIS calcule en `EffectiveOverrideMode` combinant logiquement les valeurs qu’il rencontre et en tenant compte de leur classement hiérarchique. Remarque : `overrideModeDefault` est un attribut facultatif qui contient l’état de verrouillage par défaut d’une section de configuration. L’attribut `overrideModeDefault` de chaque section de configuration se trouve dans la définition de section correspondante sous `<configSections>` le fichier ApplicationHost.config. Si `overrideModeDefault` est manquante, sa valeur est « Autoriser ». Si « Autoriser » est spécifié, les fichiers Web.config de niveau inférieur peuvent remplacer les paramètres de la section ; si « Deny » est spécifié, ils ne peuvent pas. La valeur par défaut `overrideModeDefault` pour la plupart des sections de serveur web IIS est « Refuser ». La valeur par défaut pour la plupart des sections ASP.NET et .NET Framework est « Autoriser », car ces sections contiennent des paramètres au niveau de l’application. L’attribut `overrideModeDefault` n’a aucune propriété correspondante dans WMI. Si vous disposez des autorisations appropriées, vous pouvez modifier le fichier ApplicationHost.config directement ou y accéder programmatiquement à l’aide de l’analyse XML ou des API d’accès aux fichiers.
`IsLocked`	Valeur `boolean` en lecture seule. `true` si la section de configuration actuelle et ses éléments enfants ne peuvent pas être modifiés ; sinon, `false`.
`LockItem`	Une valeur `boolean` en lecture/écriture. `true` si la section de configuration actuelle et ses éléments enfants sont verrouillés ; sinon, `false`. Par défaut, il s’agit de `false`. Remarque : Bien que la valeur par défaut soit `false`, cette propriété retourne `null` lorsqu’elle est lue initialement. Si vous définissez explicitement cette valeur initiale sur `false`, la propriété retourne toujours `null`. Toutefois, si vous définissez la valeur initiale sur `true`, la propriété retourne `true`; si vous définissez ensuite la valeur sur `false`, la propriété retourne explicitement `false`. Ce comportement est dû à une limitation dans le fournisseur WMI.
`OverrideMode`	Valeur en lecture/écriture `string` qui spécifie si les fichiers de configuration de niveau inférieur peuvent remplacer les paramètres dans la section de configuration actuelle. Les valeurs possibles sont répertoriées plus loin dans la section Remarques.

Sous-classes

Cette classe ne contient aucune sous-classe.

Notes

Les instances de cette classe sont contenues dans la propriété SectionInformation de la classe ConfigurationSection. Toutes les classes de section de configuration héritent de la classe SectionInformation comme l’une de leurs propriétés.

Le tableau suivant répertorie les valeurs possibles pour la propriété EffectiveOverrideMode.

Mot clé	Description
`Allow`	Les fichiers de configuration de niveau inférieur peuvent remplacer les paramètres de la section de configuration actuelle.
`Deny`	Les fichiers de configuration de niveau inférieur ne peuvent pas remplacer les paramètres de la section de configuration actuelle.

Le tableau suivant répertorie les valeurs possibles pour la propriété OverrideMode. La valeur par défaut est Inherit (Hériter).

Mot clé	Description
`Inherit`	Les fichiers de configuration de niveau inférieur peuvent ou ne peuvent pas remplacer les paramètres de la section de configuration actuelle, en fonction de la combinaison de valeurs `OverrideMode` qu’ils héritent.
`Allow`	Les fichiers de configuration de niveau inférieur peuvent remplacer les paramètres de la section de configuration actuelle.
`Deny`	Les fichiers de configuration de niveau inférieur ne peuvent pas remplacer les paramètres de la section de configuration actuelle.

Remarque

La propriété EffectiveOverrideMode est utile pour déterminer le mode de remplacement effectif d’une section de configuration lorsque la propriété OverrideMode est définie sur « Hériter ».

Exemple

L’exemple suivant récupère les propriétés SectionInformation de toutes les sections de configuration.

' Connect to the WMI WebAdministration namespace.  
Set oWebAdmin = GetObject("winmgmts:root\WebAdministration")  
  
' Retrieve configuration sections.  
Set oConfigSections = oWebAdmin.ExecQuery( _  
    "SELECT * FROM ConfigurationSection")  
  
' Loop through the configuration sections.  
For Each oConfigSection In oConfigSections  
    iCounter = iCounter + 1  
  
    ' Display the name of each configuration section and its location.  
    WScript.Echo "[" & iCounter & "] " & oConfigSection.Path_.Class  
    WScript.Echo "Location: " & oConfigSection.Location  
  
    ' Display the SectionInformation property values.  
    Set oConfigSectionInfo = oConfigSection.SectionInformation  
    WScript.Echo "Effective Override Mode: " & _  
        oConfigSectionInfo.EffectiveOverrideMode  
    WScript.Echo "Is Locked: " & oConfigSectionInfo.IsLocked  
    WScript.Echo "Is Present: " & oConfigSectionInfo.IsPresent          
    WScript.Echo "Lock Item: " & oConfigSectionInfo.LockItem              
    WScript.Echo "Override Mode: " & oConfigSectionInfo.OverrideMode  
    WScript.Echo "------------------------------------------"  
Next

Hiérarchie d'héritage

EmbeddedObject

SectionInformation

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 sous 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 sous 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
Classe EmbeddedObject

Partager via