SectionInformation-Klasse

Artikel
03/28/2024

Gibt Einstellungen für den Außerkraftsetzungsmodus und die Steuerungssperre für einen Konfigurationsabschnitt an.

Syntax

class SectionInformation : EmbeddedObject

Methoden

Diese Klasse enthält keine Methoden.

Eigenschaften

In der folgenden Tabelle sind die Eigenschaften aufgeführt, die von der SectionInformation-Klasse verfügbar gemacht werden.

Name	Beschreibung
`EffectiveOverrideMode`	Ein `string` schreibgeschützter Wert, der angibt, ob der aktuelle Konfigurationsabschnitt seine geerbten Einstellungen effektiv überschreiben kann. Die möglichen Werte werden weiter unten im Abschnitt Hinweise aufgeführt. Um den Wert von `EffectiveOverrideMode` zu ermitteln, durchläuft IIS die Vererbungshierarchie von Konfigurationsabschnitten aus dem aktuellen Abschnitt. Anschließend wird die `OverrideMode` Eigenschaft jedes übergeordneten Abschnitts untersucht, bis es das `overrideModeDefault` Attribut in der Abschnittsschemadefinition erreicht. IIS berechnet die `EffectiveOverrideMode`, indem es die gefundenen Werte logisch kombiniert und deren hierarchische Rangfolge berücksichtigt. Hinweis: `overrideModeDefault` ist ein optionales Attribut, das den Standardsperrmodusstatus eines Konfigurationsabschnitts enthält. Das `overrideModeDefault` Attribut für jeden Konfigurationsabschnitt befindet sich in der entsprechenden Abschnittsdefinition unter `<configSections>` der Datei ApplicationHost.config. Wenn `overrideModeDefault` fehlt, lautet der Wert "Allow". Wenn "Allow" angegeben ist, können Web.config-Dateien auf niedrigerer Ebene Einstellungen für den Abschnitt überschreiben. Wenn "Deny" angegeben ist, können sie nicht überschreiben. Die `overrideModeDefault` Standardeinstellung für die meisten IIS-Webserverabschnitte lautet "Deny". Der Standardwert für die meisten Abschnitte ASP.NET und .NET Framework lautet "Allow", da diese Abschnitte Einstellungen auf Anwendungsebene enthalten. Das `overrideModeDefault` Attribut hat keine entsprechende Eigenschaft in WMI. Wenn Sie über entsprechende Berechtigungen verfügen, können Sie die ApplicationHost.config-Datei direkt bearbeiten oder programmgesteuert mithilfe von XML-Analyse- oder Dateizugriffs-APIs darauf zugreifen.
`IsLocked`	Ein schreibgeschützter `boolean`-Wert. `true` wenn der aktuelle Konfigurationsabschnitt und seine untergeordneten Elemente nicht geändert werden können; andernfalls `false`.
`LockItem`	Ein `boolean` Lese-/Schreibwert. `true` wenn der aktuelle Konfigurationsabschnitt und seine untergeordneten Elemente gesperrt sind; andernfalls `false`. Der Standardwert ist `false`. Hinweis: Obwohl die Standardeinstellung `false` lautet, gibt diese Eigenschaft beim anfänglichen Lesen `null` zurück. Wenn Sie diesen Anfangswert explizit auf `false` festlegen, gibt die Eigenschaft weiterhin `null` zurück. Wenn Sie den Anfangswert jedoch auf `true` setzen, gibt die Eigenschaft `true` zurück; wenn Sie dann den Wert auf `false` festlegen, gibt die Eigenschaft explizit `false` zurück. Dieses Verhalten ist auf eine Einschränkung des WMI-Anbieters zurückzuführen.
`OverrideMode`	Ein `string` Lese-/Schreibwert, der angibt, ob Konfigurationsdateien auf niedrigerer Ebene die Einstellungen im aktuellen Konfigurationsabschnitt überschreiben können. Die möglichen Werte werden weiter unten im Abschnitt Hinweise aufgeführt.

Unterklassen

Diese Klasse enthält keine Unterklassen.

Hinweise

Instanzen dieser Klasse sind in der SectionInformation Eigenschaft der ConfigurationSection-Klasse enthalten. Alle Konfigurationsabschnittsklassen erben die SectionInformation Klasse als eine ihrer Eigenschaften.

In der folgenden Tabelle werden die verschiedenen möglichen Werte für die EffectiveOverrideMode Eigenschaft angezeigt.

Schlüsselwort	Beschreibung
`Allow`	Konfigurationsdateien auf niedrigerer Ebene können die Einstellungen im aktuellen Konfigurationsabschnitt überschreiben.
`Deny`	Konfigurationsdateien auf niedrigerer Ebene können die Einstellungen im aktuellen Konfigurationsabschnitt nicht außer Kraft setzen.

In der folgenden Tabelle werden die verschiedenen möglichen Werte für die OverrideMode Eigenschaft angezeigt. Der Standardwert ist "Inherit".

Schlüsselwort	Beschreibung
`Inherit`	Konfigurationsdateien auf niedrigerer Ebene können die Einstellungen im aktuellen Konfigurationsabschnitt abhängig von der Kombination von `OverrideMode` Werten, die sie erben, außer Kraft setzen.
`Allow`	Konfigurationsdateien auf niedrigerer Ebene können die Einstellungen im aktuellen Konfigurationsabschnitt überschreiben.
`Deny`	Konfigurationsdateien auf niedrigerer Ebene können die Einstellungen im aktuellen Konfigurationsabschnitt nicht außer Kraft setzen.

Hinweis

Die EffectiveOverrideMode Eigenschaft ist nützlich, um zu bestimmen, was der effektive Außerkraftsetzungsmodus für einen Konfigurationsabschnitt ist, wenn die OverrideMode Eigenschaft auf "Inherit" festgelegt ist.

Beispiel

Im folgenden Beispiel werden die SectionInformation Eigenschaften für alle Konfigurationsabschnitte abgerufen.

' 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

Vererbungshierarchie

EmbeddedObject

SectionInformation

Anforderungen

type	Beschreibung
Client	- IIS 7.0 unter Windows Vista IIS 7.5 unter Windows 7 IIS 8.0 unter Windows 8 IIS 10.0 unter Windows 10
Server	IIS 7.0 unter Windows Server 2008 - IIS 7.5 unter Windows Server 2008 R2 IIS 8.0 auf Windows Server 2012. - IIS 8.5 unter Windows Server 2012 R2 IIS 10.0 auf Windows Server 2016.
Produkt	- IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0
MOF-Datei	WebAdministration.mof

Weitere Informationen

ConfigurationSection-Klasse
EmbeddedObject-Klasse

Freigeben über