LogFileEventConsumer-Klasse
Die LogFileEventConsumer-Klasse schreibt benutzerdefinierte Zeichenfolgen in eine Textprotokolldatei, wenn Ereignisse an sie übermittelt werden. Die Zeichenfolgen werden durch Zeilenendesequenzen getrennt. Diese Klasse ist einer der Standardereignisconsumer, die WMI bereitstellt. Weitere Informationen finden Sie unter Überwachen von Ereignissen und Reagieren auf Ereignisse mit Standardconsumern.
Syntax
[AMENDMENT]
class LogFileEventConsumer : __EventConsumer
{
uint8 CreatorSID[];
string MachineName;
uint32 MaximumQueueSize;
string Filename;
boolean IsUnicode;
uint64 MaximumFileSize = 65535;
string Name;
string Text;
};
Member
Die Klasse LogFileEventConsumer verfügt über die folgenden Membertypen:
Eigenschaften
Die Klasse LogFileEventConsumer verfügt über die folgenden Eigenschaften.
-
CreatorSID
-
-
Datentyp: uint8-Array
-
Zugriffstyp: Schreibgeschützt
Die Sicherheits-ID (SID), die den Benutzer oder die Benutzerin, der/die einen Filter erstellt, eindeutig identifiziert. Je nach Betriebssystem speichert WMI die SID des Benutzers bzw. der Benutzerin, der/die eine Instanz von __EventConsumer erstellt, oder die Administrator-SID. Weitere Informationen finden Sie unter Binden eines Ereignisfilters an einen logischen Consumer und Überwachen von Ereignissen und Reagieren auf Ereignisse mit Standardconsumern.
Diese Eigenschaft wird von __EventConsumer geerbt.
-
-
Filename
-
-
Datentyp: string
-
Zugriffstyp: Schreibgeschützt
Name einer Datei, der den Pfad enthält, an den die Protokolleinträge angefügt werden. Wenn die Datei nicht vorhanden ist, versucht LogFileEventConsumer, sie zu erstellen. Der Consumer schlägt fehl, wenn der Pfad nicht vorhanden ist oder wenn der Benutzer, der den Consumer erstellt, keine Schreibberechtigungen für die Datei oder den Pfad besitzt.
-
-
IsUnicode
-
-
Datentyp: Boolesch
-
Zugriffstyp: Schreibgeschützt
Wenn TRUE handelt es sich bei der Protokolldatei um eine Unicode-Textdatei. Wenn FALSE handelt es sich bei der Protokolldatei um eine Multibytecode-Textdatei. Wenn die Datei vorhanden ist, wird diese Eigenschaft ignoriert und die aktuelle Dateieinstellung verwendet. Wenn IsUnicode beispielsweise FALSE ist, die vorhandene Datei aber eine Unicode-Datei ist, wird Unicode verwendet. Wenn IsUnicode den Wert TRUE besitzt, die Datei jedoch Multibytecode ist, wird Multibytecode verwendet.
-
-
MachineName
-
-
Datentyp: string
-
Zugriffstyp: Schreibgeschützt
Der Name des Computers, an den die Windows-Verwaltungsinstrumentation (Windows Management Instrumentation, WMI) Ereignisse sendet.
Diese Eigenschaft wird von __EventConsumer geerbt.
-
-
MaximumFileSize
-
-
Datentyp: uint64
-
Zugriffstyp: Schreibgeschützt
Die maximale Größe einer Protokolldatei in Byte. Wenn die primäre Datei ihre maximale Größe überschreitet, wird der Inhalt in eine andere Datei verschoben, und die primäre Datei wird geleert. Ein Wert von 0 (Null) bedeutet, dass es keine Größenbeschränkung gibt. Der Standardwert ist 65.535 Bytes. Die Größe der Datei wird vor einem Schreibvorgang überprüft. Daher können Sie über eine Datei verfügen, die etwas größer als die angegebene Größenbegrenzung ist. Der nächste Schreibvorgang fängt sie ab und startet eine neue Datei.
In der folgenden Liste wird die Benennungsstruktur für die Sicherungsdatei angegeben:
- Wenn der ursprüngliche Dateiname 8.3 ist, wird die Erweiterung durch eine Zeichenfolge im Format „001“, „002“ usw. mit der kleinsten Zahl ersetzt, die größer als alle zuvor verwendeten und ausgewählten Zahlen ist. Wenn „999“ verwendet wird, ist die ausgewählte Zahl die kleinste nicht verwendete Zahl.
- Wenn der ursprüngliche Dateiname nicht 8.3 ist, wird eine Zeichenfolge im Format „001“, „002“ usw. an den Dateinamen angefügt.
Weitere Informationen zur Verwendung von uint64-Werten in Skripts finden Sie unter Skripterstellung in WMI.
-
-
MaximumQueueSize
-
-
Datentyp: uint32
-
Zugriffstyp: Schreibgeschützt
Die maximale Warteschlange für einen bestimmten Consumer in Byte.
Diese Eigenschaft wird von __EventConsumer geerbt.
-
-
Name
-
-
Datentyp: string
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: Key
Eindeutiger Name für diesen Consumer.
-
-
Text
-
-
Datentyp: string
-
Zugriffstyp: Schreibgeschützt
Standardzeichenfolgenvorlage für den Text eines Protokolleintrags.
-
Bemerkungen
Hinweis
LogFileEventConsumer schützt die Protokolldatei nicht. Daher ist es beim Konfigurieren von LogFileEventConsumer wichtig, ein Verzeichnis anzugeben, das auf der von Ihnen benötigten Ebene gesichert ist.
Die LogFileEventConsumer-Klasse wird von der abstrakten Klasse __EventConsumer abgeleitet.
Beispiele
Ein Beispiel für die Verwendung von LogFileEventConsumer zum Erstellen eines Consumers finden Sie unter Schreiben in eine Protokolldatei basierend auf einem Ereignis.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Vista |
| Unterstützte Mindestversion (Server) |
Windows Server 2008 |
| Namespace |
Root\subscription |
| MOF |
|
| DLL |
|