LogSection-Klasse1

Artikel
03/28/2024

Konfiguriert die Protokollierung für einen Server oder Standort.

Syntax

class LogSection : ConfigurationSection

Methoden

In der folgenden Tabelle werden die Methoden aufgelistet, die von der LogSectionKlasse verfügbar gemacht werden.

Name	Beschreibung
GetAllowDefinition	(Geerbt von ConfigurationSection.)
GetAllowLocation	(Geerbt von `ConfigurationSection`.)
RevertToParent	(Geerbt von `ConfigurationSection`.)
SetAllowDefinition	(Geerbt von `ConfigurationSection`.)
SetAllowLocation	(Geerbt von `ConfigurationSection`.)

Eigenschaften

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

Name	Beschreibung
`CentralBinaryLogFile`	Ein Lese-/Schreib-Wert vom Typ CentralBinaryLogFile , der die Konfiguration der zentralisierten binären Protokollierung für alle Websites auf einem Server angibt.
`CentralLogFileMode`	Ein Lese-/Schreib`sint32`-Wert , der den zentralisierten Protokollierungsmodus für den Server angibt. Die möglichen Werte werden weiter unten im Abschnitt Hinweise aufgeführt.
`CentralW3CLogFile`	Ein Lese-/Schreib-Wert vom Typ CentralW3CLogFile , der die Konfiguration des World Wide Web Consortium (W3C) für alle Websites auf einem Server angibt.
`Location`	(Geerbt von `ConfigurationSection`.) Eine Schlüsseleigenschaft.
`LogInUTF8`	Ein Lese-/Schreib`boolean`-Wert. `true` wenn IIS alle Zeichenfolgen im UCS-Transformationsformat 8 (UTF-8) protokolliert; andernfalls, `false`. Der Standardwert ist `true`. Diese Einstellung gilt serverweit für alle Textmodusprotokollierung.
`Path`	(Geerbt von `ConfigurationSection`.) Eine Schlüsseleigenschaft.
`SectionInformation`	(Geerbt von `ConfigurationSection`.)

Unterklassen

Diese Klasse enthält keine Unterklassen.

Hinweise

Diese Klasse entspricht dem <system.applicationHost/log> Abschnitt in ApplicationHost.config.

In der folgenden Tabelle werden die verschiedenen möglichen Werte für die CentralLogFileMode Eigenschaft angezeigt. Der Standardwert ist 0 (Site).

Wert	Schlüsselwort	Beschreibung
0	`Site`	Alle Clientanforderungen werden auf Standortebene protokolliert, nicht zentral auf Serverebene. Protokolldateien werden pro Website generiert.
1	`CentralBinary`	Alle Clientanforderungen für alle Websites werden in einer einzigen Protokolldatei im zentralisierten Binärformat auf dem Server protokolliert.
2	`CentralW3C`	Alle Clientanforderungen für alle Websites werden in einer einzigen Protokolldatei im zentralisierten W3C-Format auf dem Server protokolliert.

Beispiel

Im folgenden Codebeispiel wird der Wert der CentralLogFileMode Eigenschaft angezeigt. Eine Hilfsfunktion übersetzt den Enumerationswert in Text.

' Connect to the WMI WebAdministration namespace.  
Set oWebAdmin = GetObject( _  
    "winmgmts:root\WebAdministration")  
  
' Get the log section.  
Set oSection = oWebAdmin.Get("LogSection.Path=" & _  
    "'MACHINE/WEBROOT/APPHOST',Location=''")  
  
' Display the class name of the section.  
WScript.Echo "[ " & oSection.Path_.Class & " ]"  
  
' Display the path and location.  
WScript.Echo "Path: " & oSection.Path  
WScript.Echo "Location: " & oSection.Location  
  
' Display the central log file mode.  
WScript.Echo "CentralLogFileMode: " & _  
                GetModeText(oSection.CentralLogFileMode)  
  
' ==== GetModeText helper function. ====  
Function GetModeText(intMode)  
    Select Case intMode  
        Case 0  
            GetModeText="Site"  
        Case 1  
            GetModeText="CentralBinary"  
        Case 2  
            GetModeText="CentralW3C"  
        Case Else  
            GetModeText="Undefined value"  
    End Select  
End Function

Vererbungshierarchie

ConfigurationSection

LogSection

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
CentralBinaryLogFile-Klasse
CentralW3CLogFile-Klasse
SiteLogFile-Klasse

Freigeben über