LogFileEventConsumer-Klasse
Die LogFileEventConsumer-Klasse schreibt benutzerdefinierte Zeichenfolgen in eine Textdatei, wenn Ereignisse an sie übermittelt werden. Die Zeichenfolgen werden durch Zeilenendesequenzen getrennt. Diese Klasse ist einer der Standardereignis-Consumers, die WMI bietet. Weitere Informationen finden Sie unter Überwachen und Reagieren auf Ereignisse mit Standardverbrauchern.
Syntax
[AMENDMENT]
class LogFileEventConsumer : __EventConsumer
{
uint8 CreatorSID[];
string MachineName;
uint32 MaximumQueueSize;
string Filename;
boolean IsUnicode;
uint64 MaximumFileSize = 65535;
string Name;
string Text;
};
Member
Die LogFileEventConsumer-Klasse verfügt über die folgenden Membertypen:
Eigenschaften
Die LogFileEventConsumer-Klasse verfügt über diese Eigenschaften.
-
CreatorSID
-
-
Datentyp: uint8 array
-
Zugriffstyp: Schreibgeschützt
Sicherheits-ID (SID), die den Benutzer, der einen Filter erstellt, eindeutig identifiziert. WMI speichert je nach Betriebssystem die SID des Benutzers, der eine Instanz von _ _ EventConsumer oder die Administrator-SID erstellt. Weitere Informationen finden Sie unter Binden eines Ereignisfilters mit einem logischen Consumer und Überwachen und Reagieren auf Ereignisse mit Standardverbrauchern.
Diese Eigenschaft wird von _ _ EventConsumer geerbt.
-
-
Filename
-
-
Datentyp: string
-
Zugriffstyp: Schreibgeschützt
Name einer Datei, die 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, nicht über Schreibberechtigungen für die Datei oder den Pfad verfügt.
-
-
IsUnicode
-
-
Datentyp: boolescher Wert
-
Zugriffstyp: Schreibgeschützt
True gibt an, dass die Protokolldatei eine Unicode-Textdatei ist. False gibt an, dass die Protokolldatei eine Multibyte-Codetextdatei ist. Wenn die Datei vorhanden ist, wird diese Eigenschaft ignoriert, und die aktuelle Dateieinstellung wird verwendet. Wenn IsUnicode beispielsweise FALSE ist, die vorhandene Datei jedoch eine Unicode-Datei ist, wird Unicode verwendet. Wenn IsUnicode TRUE ist, die Datei jedoch Multibytecode ist, wird Multibytecode verwendet.
-
-
MachineName
-
-
Datentyp: string
-
Zugriffstyp: Schreibgeschützt
Name des Computers, an den die Windows Management Instrumentation (WMI) Ereignisse sendet.
Diese Eigenschaft wird von _ _ EventConsumer geerbt.
-
-
MaximumFileSize
-
-
Datentyp: uint64
-
Zugriffstyp: Schreibgeschützt
Maximale Größe einer Protokolldatei in Bytes. Wenn die primäre Datei ihre maximale Größe überschreitet, wird der Inhalt in eine andere Datei verschoben und die primäre Datei geleert. Der Wert 0 (null) bedeutet, dass keine Größenbeschränkung besteht. 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ößenbeschränkung ist. Der nächste Schreibvorgang fängt es ab und startet eine neue Datei.
In der folgenden Liste ist die Namensstruktur für die Sicherungsdatei aufgeführt:
- Wenn der ursprüngliche Dateiname 8.3 ist, wird die Erweiterung durch eine Zeichenfolge im Format "001", "002" und so weiter durch die kleinste 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" und so weiter 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
Maximale Warteschlange für einen bestimmten Consumer in Bytes.
Diese Eigenschaft wird von _ _ EventConsumer geerbt.
-
-
Name
-
-
Datentyp: string
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: Schlüssel
Eindeutiger Name für diesen Consumer.
-
-
Text
-
-
Datentyp: string
-
Zugriffstyp: Schreibgeschützt
Standardzeichenfolgenvorlage für den Text eines Protokolleintrags.
-
Hinweise
Hinweis
LogFileEventConsumer sichert die Protokolldatei nicht. Daher ist es beim Konfigurieren von LogFileEventConsumer wichtig, ein Verzeichnis anzugeben, das auf der von Ihnen benötigten Ebene geschützt ist.
Die LogFileEventConsumer-Klasse wird von der abstrakten _ _ EventConsumer-Klasse 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 |
\Stammabonnement |
| MOF |
|
| DLL |
|