Partager via

Write-EventLog

Module:
Microsoft.PowerShell.Management Module

Écrit un événement dans un journal des événements.

Syntaxe

Default (Par défaut) 

Write-EventLog
    [-LogName] <String>
    [-Source] <String>
    [[-EntryType] <EventLogEntryType>]
    [-Category <Int16>]
    [-EventId] <Int32>
    [-Message] <String>
    [-RawData <Byte[]>]
    [-ComputerName <String>]
    [<CommonParameters>]

Description

La cmdlet Write-EventLog écrit un événement dans un journal des événements.

Pour écrire un événement dans un journal des événements, le journal des événements doit exister sur l’ordinateur et la source doit être inscrite pour le journal des événements.

Les applets de commande qui contiennent les EventLog nom (les applets de commande EventLog ) fonctionnent uniquement sur les journaux d’événements classiques. Pour obtenir des événements à partir de journaux qui utilisent la technologie du journal des événements Windows dans Windows Vista et les versions ultérieures du système d’exploitation Windows, utilisez l’applet de commande Get-WinEvent.

Exemples

Exemple 1 : Écrire un événement dans le journal des événements d’application

PS C:\> Write-EventLog -LogName "Application" -Source "MyApp" -EventID 3001 -EntryType Information -Message "MyApp added a user-requested feature to the display." -Category 1 -RawData 10,20

Cette commande écrit un événement à partir de la source MyApp dans le journal des événements de l’application.

Exemple 2 : Écrire un événement dans le journal des événements d’application d’un ordinateur distant

PS C:\> Write-EventLog -ComputerName "Server01" -LogName Application -Source "MyApp" -EventID 3001 -Message "MyApp added a user-requested feature to the display."

Cette commande écrit un événement de la source MyApp dans le journal des événements d’application sur l’ordinateur distant Server01.

Paramètres

-Category

Spécifie une catégorie de tâche pour l’événement. Entrez un entier associé aux chaînes du fichier de message de catégorie pour le journal des événements.

Propriétés du paramètre

Type:Int16
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-ComputerName

Spécifie un ordinateur distant. La valeur par défaut est l’ordinateur local.

Tapez le nom NetBIOS, une adresse IP ou un nom de domaine complet d’un ordinateur distant.

Ce paramètre ne s’appuie pas sur la communication à distance Windows PowerShell. Vous pouvez utiliser le paramètre ComputerName de l’applet de commande Get-EventLog même si votre ordinateur n’est pas configuré pour exécuter des commandes distantes.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:CN

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-EntryType

Spécifie le type d’entrée de l’événement. Les valeurs acceptables pour ce paramètre sont : Erreur, Avertissement, Informations, SuccessAudit et FailureAudit. La valeur par défaut est Information.

Pour obtenir une description des valeurs, consultez 'énumération EventLogEntryType dans la bibliothèque MSDN.

Propriétés du paramètre

Type:EventLogEntryType
Valeur par défaut:None
Valeurs acceptées:Error, Information, FailureAudit, SuccessAudit, Warning
Prend en charge les caractères génériques:False
DontShow:False
Alias:ET

Jeux de paramètres

(All)
Position:3
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-EventId

Spécifie l’identificateur d’événement. Ce paramètre est obligatoire. La valeur maximale du paramètre EventId est 65535.

Propriétés du paramètre

Type:Int32
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:ID, EID

Jeux de paramètres

(All)
Position:2
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-LogName

Spécifie le nom du journal dans lequel l’événement est écrit. Entrez le nom du journal. Le nom du journal est la valeur de la propriété Log, et non LogDisplayName. Les caractères génériques ne sont pas autorisés. Ce paramètre est obligatoire.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:LN

Jeux de paramètres

(All)
Position:0
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Message

Spécifie le message d’événement. Ce paramètre est obligatoire.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:MSG

Jeux de paramètres

(All)
Position:4
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-RawData

Spécifie les données binaires associées à l’événement, en octets.

Propriétés du paramètre

Type:

Byte[]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:RD

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Source

Spécifie la source d’événement, qui est généralement le nom de l’application qui écrit l’événement dans le journal.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:SRC

Jeux de paramètres

(All)
Position:1
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Entrées

None

Vous ne pouvez pas diriger d'entrée vers cette applet de commande.

Sorties

EventLogEntry

Cette applet de commande retourne des objets qui représentent les événements dans les journaux d’activité.

Notes

  • Pour utiliser Write-EventLog, démarrez Windows PowerShell à l’aide de l’option Exécuter en tant qu’administrateur.