CentralBinaryLogFile-Klasse1

Artikel
03/25/2024

Konfiguriert Einstellungen für die zentralisierte binäre Protokollierung auf einem Server.

Syntax

class CentralBinaryLogFile : EmbeddedObject

Methoden

Diese Klasse enthält keine Methoden.

Eigenschaften

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

Name	Beschreibung
`Directory`	Ein Lese-/Schreibwert `string`, der das Verzeichnis angibt, in das Protokolleinträge geschrieben werden sollen. Der Standardwert ist %SystemDrive%\inetpub\logs\LogFiles.
`Enabled`	Ein Lese-/Schreib`boolean`-Wert. `true` wenn die zentralisierte binäre Protokollierung aktiviert ist; andernfalls, `false`. Der Standardwert ist `true`.
`LocalTimeRollover`	Ein Lese-/Schreib`boolean`-Wert. `true` wenn eine neue Protokolldatei auf lokaler Zeit basiert; `false` wenn sie auf koordinierter Weltzeit (COORDINATED Universal Time, UTC) basiert. Der Standardwert ist `false`.
`Period`	Eine Lese-/Schreibzugriff `sint32`-Enumeration, 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-/Schreib `string`-Wert , der in Bytes die Größe angibt, in der der Inhalt der Protokolldatei abgeschnitten werden soll. Dieses Attribut muss konfiguriert werden, wenn `Period` sie auf `MaxSize`eingestellt ist. Die Größe muss zwischen 1048576 (1 MB) und 4294967295 (4 Gigabyte) betragen. Der Standardwert ist 20971520 (20 Mb).

Unterklassen

Diese Klasse enthält keine Unterklassen.

Hinweise

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

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

Im folgenden Codebeispiel wird der Protokolldateimodus auf CentralBinaryfestgestellt, die binäre Protokollierung aktiviert, die Period Eigenschaft auf Weeklyfestgelegt, festgelegt, dass Protokolldateien lokale Zeit verwenden, und die Protokollgröße auf 1 Gigabyte begrenzt. 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 CentralBinary.  
oSection.CentralLogFileMode = 1  
  
' Enable central binary logging.  
oSection.CentralBinaryLogFile.Enabled = True  
  
' Set local time rollover to true.  
oSection.CentralBinaryLogFile.LocalTimeRollover = True  
  
' Set the Period property to Weekly.  
oSection.CentralBinaryLogFile.Period = 2  
  
' Set the log truncate size to 1 gigabyte.  
oSection.CentralBinaryLogFile.TruncateSize = 1073741824  
  
' 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 binary log file properties.  
   Call ShowPropVals(oSection.CentralBinaryLogFile)  
  
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

CentralBinaryLogFile

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

CentralW3CLogFile-Klasse
EmbeddedObject-Klasse
LogSection-Klasse
SiteLogFile-Klasse

Freigeben über