HttpLoggingSection-Klasse1

Artikel
03/28/2024

Konfiguriert die Protokollierung von HTTP-Anforderungen.

Syntax

class HttpLoggingSection : ConfigurationSection

Methoden

In der folgenden Tabelle werden die Methoden aufgelistet, die von der HttpLoggingSection-Klasse 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 werden die Eigenschaften aufgeführt, die von der HttpLoggingSection Klasse verfügbar gemacht werden.

Name	Beschreibung
`DontLog`	Ein Lese-/Schreibwert `boolean`. `true`, wenn die Protokollierung für erfolgreiche Anforderungen deaktiviert ist; `false`, wenn erfolgreiche Anforderungen protokolliert werden. Eine Anforderung wird als erfolgreich betrachtet, wenn ihr Statuscode kleiner als 400 ist. Der Standardwert ist `false`. Hinweis: Diese Eigenschaft ist identisch mit der DontLog-Metabasiseigenschaft in IIS 6.0.
`Location`	(Geerbt von `ConfigurationSection`.) Eine Schlüsseleigenschaft.
`Path`	(Geerbt von `ConfigurationSection`.) Eine Schlüsseleigenschaft.
`SectionInformation`	(Geerbt von `ConfigurationSection`.)
`SelectiveLogging`	Eine `sint32`-Enumeration, die die zu protokollierenden Ereignisse angibt. Die möglichen Werte werden weiter unten im Abschnitt Hinweise aufgeführt.

Unterklassen

Diese Klasse enthält keine Unterklassen.

Hinweise

Diese Klasse entspricht dem <system.webServer/httpLogging>-Abschnitt in der Datei ApplicationHost.config.

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

Wert	Schlüsselwort	Beschreibung
0	`LogAll`	Alle Anforderungen werden protokolliert.
1	`LogSuccessful`	Es werden nur erfolgreiche Anforderungen protokolliert. Eine Anforderung wird als erfolgreich betrachtet, wenn ihr Statuscode kleiner als 400 ist.
2	`LogError`	Es werden nur fehlgeschlagene Anforderungen protokolliert. Eine Anforderung wird als fehlgeschlagen betrachtet, wenn ihr Statuscode größer oder gleich 400 ist.

Beispiel

Das folgende Codebeispiel legt die SelectiveLogging-Eigenschaft auf LogError fest.

' Connect to the WMI WebAdministration namespace.  
Set oWebAdmin = GetObject( _  
    "winmgmts:root\WebAdministration")  
  
' Get the HTTP logging section.  
Set oSection = oWebAdmin.Get( _  
    "HttpLoggingSection.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 SelectiveLogging property to LogError.  
    oSection.SelectiveLogging = 2  
  
' Save new values to configuration.  
oSection.Put_  
  
' Refresh the oSection object variable with new values.  
oSection.Refresh_  
  
' Show 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 "DontLog: " & oSection.DontLog  
    WScript.Echo "SelectiveLogging: " & _  
        oSection.SelectiveLogging  
    WScript.Echo  
End Function

Vererbungshierarchie

ConfigurationSection

HttpLoggingSection

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

CentralBinaryLogFile-Klasse
CentralW3CLogFile-Klasse
ConfigurationSection-Klasse
OdbcLoggingSection-Klasse
LogSection-Klasse
SiteLogFile-Klasse
DontLog-Metabasiseigenschaft (IIS 6.0)

Freigeben über