Classe LogFileEventConsumer
La classe LogFileEventConsumer écrit des chaînes personnalisées dans un fichier journal texte lorsque des événements lui sont remis. Les chaînes sont séparées par des séquences de fin de ligne. Cette classe est l’un des consommateurs d’événements standard que WMI fournit. Pour plus d’informations, voir Surveillance et réponse aux événements avec des consommateurs standard.
Syntaxe
[AMENDMENT]
class LogFileEventConsumer : __EventConsumer
{
uint8 CreatorSID[];
string MachineName;
uint32 MaximumQueueSize;
string Filename;
boolean IsUnicode;
uint64 MaximumFileSize = 65535;
string Name;
string Text;
};
Membres
La classe LogFileEventConsumer possède ces types de membres :
Propriétés
La classe LogFileEventConsumer possède les propriétés suivantes.
-
CreatorSID
-
-
Type de données : tableau uint8
-
Type d'accès : Lecture seule
Identificateur de sécurité (SID) qui identifie de manière unique l’utilisateur qui crée un filtre. WMI stocke le SID de l’utilisateur qui crée une instance de __EventConsumer ou le SID de l’administrateur, en fonction du système d’exploitation. Pour plus d’informations, consultez Liaison d’un filtre d’événement à un consommateur logique et Monitoring des événements et réponse à ces derniers avec des consommateurs standard.
Cette propriété est héritée de __EventConsumer.
-
-
Nom du fichier
-
-
Type de données : chaîne
-
Type d'accès : Lecture seule
Nom d’un fichier qui inclut le chemin d’accès auquel les entrées de journal sont ajoutées. Si le fichier n'existe pas, LogFileEventConsumer tente de le créer. Le consommateur échoue lorsque le chemin d’accès n’existe pas, ou lorsque l’utilisateur qui crée le consommateur ne dispose pas des autorisations d’écriture pour le fichier ou le chemin d’accès.
-
-
IsUnicode
-
-
Type de données : booléen
-
Type d'accès : Lecture seule
Si la valeur est TRUE, le fichier journal est un fichier texte Unicode. Si la valeur est FALSE, le fichier journal est un fichier texte de code multioctet. Si le fichier existe, cette propriété est ignorée et le paramètre de fichier actuel est utilisé. Par exemple, si IsUnicode est FALSE, mais que le fichier existant est un fichier Unicode, Unicode est utilisé. Si IsUnicode est TRUE, mais que le fichier est du code multioctet, le code multioctet est utilisé.
-
-
MachineName
-
-
Type de données : chaîne
-
Type d'accès : Lecture seule
Nom de l’ordinateur auquel WMI (Windows Management Instrumentation) envoie les événements.
Cette propriété est héritée de __EventConsumer.
-
-
MaximumFileSize
-
-
Type de données : uint64
-
Type d'accès : Lecture seule
Taille maximale du fichier journal, en octets. Si le fichier principal dépasse sa taille maximale, le contenu est déplacé vers un autre fichier et le fichier principal est vidé. Une valeur de 0 (zéro) signifie qu'il n'y a pas de limite de taille. La valeur par défaut est 65,535 octets. La taille du fichier est vérifiée avant une opération d’écriture. Par conséquent, vous pouvez avoir un fichier légèrement supérieur à la limite de taille spécifiée. L’opération d’écriture suivante l’intercepte et démarre un nouveau fichier.
La liste suivante identifie la structure de dénomination du fichier de sauvegarde :
- Si le nom de fichier d’origine est 8.3, l’extension est remplacée par une chaîne au format « 001 », « 002 », et ainsi de suite avec le plus petit nombre supérieur à tous les nombres précédemment utilisés et choisis. Si « 999 » est utilisé, le nombre choisi est le plus petit nombre inutilisé.
- Si le nom de fichier d’origine n’est pas 8.3, une chaîne au format « 001 », « 002 », etc. est ajoutée au nom de fichier.
Pour plus d’informations sur l’utilisation de valeurs uint64 dans des scripts, voir Scripts dans WMI.
-
-
MaximumQueueSize
-
-
Type de données : uint32
-
Type d'accès : Lecture seule
File d’attente maximale pour un consommateur spécifique, en octets.
Cette propriété est héritée de __EventConsumer.
-
-
Nom
-
-
Type de données : chaîne
-
Type d'accès : Lecture seule
-
Qualificateurs : clé
Nom unique de ce consommateur.
-
-
Texte
-
-
Type de données : chaîne
-
Type d'accès : Lecture seule
Modèle de chaîne standard pour le texte d'une entrée de journal.
-
Notes
Notes
LogFileEventConsumer ne sécurise pas le fichier journal. Par conséquent, lorsque vous configurez LogFileEventConsumer, il est important de spécifier un répertoire sécurisé au niveau dont vous avez besoin.
La classe LogFileEventConsumer est dérivée de la classe abstraite __EventConsumer.
Exemples
Pour obtenir un exemple d’utilisation de LogFileEventConsumer pour créer un consommateur, consultez Écriture dans un fichier journal basé sur un événement.
Spécifications
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge |
Windows Vista |
| Serveur minimal pris en charge |
Windows Server 2008 |
| Espace de noms |
Root\subscription |
| MOF |
|
| DLL |
|