CentralW3CLogFile-Klasse1

Artikel
03/28/2024

Konfiguriert Einstellungen für die zentralisierte Protokollierung von World Wide Web Consortium (W3C) auf einem Server.

Syntax

class CentralW3CLogFile : EmbeddedObject

Methoden

Diese Klasse enthält keine Methoden.

Eigenschaften

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

Name	Beschreibung
`Directory`	Ein wert ohne Schreibzugriff `string`, der das Verzeichnis angibt, in das Protokolleinträge geschrieben werden sollen. Der Standardwert ist „%SystemDrive%\inetpub\logs\LogFiles“.
`Enabled`	Ein Lese-/Schreibwert `boolean`. `true`, wenn die zentrale W3C-Protokollierung aktiviert ist; andernfalls `false`. Der Standardwert ist `true`.
`LocalTimeRollover`	Ein Lese-/Schreibwert `boolean`. `true`, wenn eine neue Protokolldatei auf lokaler Zeit basiert; `false` wenn sie auf koordinierter Weltzeit (COORDINATED Universal Time, UTC) basiert. Der Standardwert ist `false`.
`LogExtFileFlags`	Ein Lese-/Schreibwert `sint32`, der eine Maske enthält, die die Attribute angibt, die in der Protokolldatei aufgezeichnet werden sollen. Die möglichen Werte werden weiter unten im Abschnitt Hinweise aufgeführt.
`Period`	Eine Aufzählung mit Lese-/Schreibzugriff `sint32`, die angibt, wie häufig die aktuelle Protokolldatei geschlossen und eine neue Protokolldatei gestartet wird. Die möglichen Werte werden weiter unten im Abschnitt Hinweise aufgeführt.
`TruncateSize`	Ein Lese-/Schreibwert `string`, der in Bytes die Größe angibt, in der der Inhalt der Protokolldatei abgeschnitten werden soll. Dieses Attribut muss konfiguriert werden, wenn `Period` auf `MaxSize` gesetzt ist. Die Größe muss zwischen 1048576 (1 MB) und 4294967295 (4 Gigabyte) betragen. Der Standardwert ist 20971520 (20 Megabyte).

Unterklassen

Diese Klasse enthält keine Unterklassen.

Hinweise

Instanzen dieser Klasse sind in der CentralW3CLogFile-Eigenschaft der LogSection-Klasse enthalten.

In der folgenden Tabelle werden die verschiedenen möglichen Werte für die LogExtFileFlags-Eigenschaft angezeigt. Die Standardattribute sind ClientIP, Date, HttpStatus, HttpSubStatus, Method, ServerIP, ServerPort, SiteName, Time, UriQuery, UriStem, UserAgent, UserName und Win32Status.

Wert	Attribut
1	`Date`
2	`Time`
4	`ClientIP`
8	`UserName`
16	`SiteName`
32	`ComputerName`
64	`ServerIP`
128 Bits	`Method`
256 KB	`UriStem`
512	`UriQuery`
1024	`HttpStatus`
2048	`Win32Status`
4096	`BytesSent`
8192	`BytesRecv`
16384	`TimeTaken`
32768	`ServerPort`
65536	`UserAgent`
131072	`Cookie`
262144	`Referer`
524288	`ProtocolVersion`
1048576	`Host`
2097152	`HttpSubStatus`

In der folgenden Tabelle werden die verschiedenen möglichen Werte für die Period-Eigenschaft angezeigt. Der Standardwert ist 1 (Daily).

Wert	Schlüsselwort	Beschreibung
0	`MaxSize`	Die Protokolldatei wird geschlossen, und eine neue Protokolldatei wird gestartet, wenn der Wert `TruncateSize` erreicht wird.
1	`Daily`	Die Protokolldatei wird geschlossen und eine neue Protokolldatei wird einmal pro Tag gestartet.
2	`Weekly`	Die Protokolldatei wird geschlossen und eine neue Protokolldatei wird einmal pro Woche gestartet.
3	`Monthly`	Die Protokolldatei wird geschlossen und eine neue Protokolldatei wird einmal pro Monat gestartet.
4	`Hourly`	Die Protokolldatei wird geschlossen und eine neue Protokolldatei wird einmal pro Stunde gestartet.

Beispiel

Das folgende Codebeispiel legt den Protokolldateimodus auf CentralW3C fest, aktiviert die zentrale W3C-Protokollierung, legt die Period-Eigenschaft auf MaxSize fest, gibt an, dass Protokolldateien die Ortszeit verwenden, und begrenzt die Protokollgröße auf 100 Megabyte. Hilfsfunktionen zeigen die Einstellungen vor und nach dem Vornehmen der Änderungen an.

' Connect to the WMI WebAdministration namespace.  
Set oWebAdmin = GetObject("winmgmts:root\WebAdministration")  
  
' Get the log configuration section.  
Set oSection = oWebAdmin.Get("LogSection.Path=" & _  
   "'MACHINE/WEBROOT/APPHOST',Location=''")  
  
' Show the initial settings.  
DisplaySettings("Initial Values")  
  
' Set the log file mode to CentralW3C.  
oSection.CentralLogFileMode = 2  
  
' Enable central W3C logging.  
oSection.CentralW3CLogFile.Enabled = True  
  
' Set local time rollover to true.  
oSection.CentralW3CLogFile.LocalTimeRollover = True  
  
' Set the Period property to MaxSize.  
oSection.CentralW3CLogFile.Period = 0  
  
' Set the log truncate size to 100 megabytes.  
oSection.CentralW3CLogFile.TruncateSize = 104857600  
  
' 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")  
  
' ==== This section contains helper functions. ====  
Function DisplaySettings(HeadingText)  
   WScript.Echo String(Len(HeadingText), "=")  
   WScript.Echo HeadingText  
   WScript.Echo String(Len(HeadingText), "=")  
  
   ' Display the current central log file mode.  
   WScript.Echo "CentralLogFileMode: " & _  
      oSection.CentralLogFileMode  
  
   ' Display the current W3C log file properties.  
   Call ShowPropVals(oSection.CentralW3CLogFile)  
  
End Function  
  
' Display the property values.  
Function ShowPropVals(oObject)  
  
   For Each Prop In oObject.Properties_  
      WScript.Echo Prop.Name & ": " & Prop.Value  
   Next  
  
   WScript.Echo  
  
End Function

Vererbungshierarchie

EmbeddedObject

CentralW3CLogFile

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
EmbeddedObject-Klasse
LogSection-Klasse
SiteLogFile-Klasse

Freigeben über