Partager via

Get-Event

  • Référence
Module:
Microsoft.PowerShell.Utility

Obtient les événements dans la file d’attente d’événements.

Syntaxe

Get-Event
   [[-SourceIdentifier] <String>]
   [<CommonParameters>]
Get-Event
   [-EventIdentifier] <Int32>
   [<CommonParameters>]

Description

L’applet de commande Get-Event obtient des événements dans la file d’attente des événements PowerShell pour la session active. Vous pouvez obtenir tous les événements ou utiliser le paramètre EventIdentifier ou SourceIdentifier pour spécifier les événements.

Lorsqu’un événement se produit, il est ajouté à la file d’attente d’événements. La file d’attente des événements inclut les événements pour lesquels vous avez inscrit, les événements créés à l’aide de l’applet de commande New-Event et l’événement déclenché lors de la fermeture de PowerShell. Vous pouvez utiliser Get-Event ou Wait-Event pour obtenir les événements.

Cette applet de commande n’obtient pas d’événements à partir des journaux de l’Observateur d’événements. Pour obtenir ces événements, utilisez Get-WinEvent ou Get-EventLog.

Exemples

Exemple 1 : Obtenir tous les événements

PS C:\> Get-Event

Cette commande obtient tous les événements de la file d’attente d’événements.

Exemple 2 : Obtenir des événements par identificateur source

PS C:\> Get-Event -SourceIdentifier "PowerShell.ProcessCreated"

Cette commande obtient les événements dans lesquels la valeur de la propriété SourceIdentifier est PowerShell.ProcessCreated.

Exemple 3 : Obtenir un événement en fonction du moment où il a été généré

PS C:\> $Events = Get-Event
PS C:\> $Events[0] | Format-List -Property *
ComputerName     :
RunspaceId       : c2153740-256d-46c0-a57c-b805917d1b7b
EventIdentifier  : 1
Sender           : System.Management.ManagementEventWatcher
SourceEventArgs  : System.Management.EventArrivedEventArgs
SourceArgs       : {System.Management.ManagementEventWatcher, System.Management.EventArrivedEventArgs}
SourceIdentifier : ProcessStarted
TimeGenerated    : 11/13/2008 12:09:32 PM
MessageData      : PS C:\> Get-Event | Where {$_.TimeGenerated -ge "11/13/2008 12:15:00 PM"}
ComputerName     :
RunspaceId       : c2153740-256d-46c0-a57c-b8059325d1a0
EventIdentifier  : 1
Sender           : System.Management.ManagementEventWatcher
SourceEventArgs  : System.Management.EventArrivedEventArgs
SourceArgs       : {System.Management.ManagementEventWatcher, System.Management.EventArrivedEventArgs}
SourceIdentifier : ProcessStarted
TimeGenerated    : 11/13/2008 12:15:00 PM
MessageData      :

Cet exemple montre comment obtenir des événements à l’aide de propriétés autres que SourceIdentifier.

La première commande obtient tous les événements de la file d’attente d’événements et les enregistre dans la variable $Events.

La deuxième commande utilise la notation de tableau pour obtenir le premier événement (0-index) dans le tableau dans la variable $Events. La commande utilise un opérateur de pipeline (|) pour envoyer l’événement à la commande Format-List, qui affiche toutes les propriétés de l’événement dans une liste. Cela vous permet d’examiner les propriétés de l’objet d’événement.

La troisième commande montre comment utiliser l’applet de commande Where-Object pour obtenir un événement en fonction de l’heure à laquelle elle a été générée.

Exemple 4 : Obtenir un événement par son identificateur

PS C:\> Get-Event -EventIdentifier 2

Cette commande obtient l’événement avec un identificateur d’événement de 2.

Paramètres

-EventIdentifier

Spécifie les identificateurs d’événement pour lesquels cette applet de commande obtient des événements.

Type:Int32
Alias:Id
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-SourceIdentifier

Spécifie les identificateurs sources pour lesquels cette applet de commande obtient des événements. La valeur par défaut est tous les événements dans la file d’attente des événements. Les caractères génériques ne sont pas autorisés.

Type:String
Position:0
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

Entrées

None

Vous ne pouvez pas diriger l’entrée vers cette applet de commande.

Sorties

PSEventArgs

Get-Event retourne un objet PSEventArgs pour chaque événement. Pour afficher une description de cet objet, tapez Get-Help Get-Event -Full et consultez la section Notes de la rubrique d’aide.

Notes

Aucune source d’événements n’est disponible sur les plateformes Linux ou macOS.

Les événements, les abonnements aux événements et la file d’attente d’événements existent uniquement dans la session active. Si vous fermez la session active, la file d’attente d’événements est ignorée et l’abonnement à l’événement est annulé.

L’applet de commande Get-Event retourne un objet PSEventArgs (System.Management.Automation.PSEventArgs) avec les propriétés suivantes :

  • ComputerName. Nom de l’ordinateur sur lequel l’événement s’est produit. Cette valeur de propriété est remplie uniquement lorsque l’événement est transféré à partir d’un ordinateur distant.

  • RunspaceId. GUID qui identifie de façon unique la session dans laquelle l’événement s’est produit. Cette valeur de propriété est remplie uniquement lorsque l’événement est transféré à partir d’un ordinateur distant.

  • EventIdentifier. Entier (Int32) qui identifie de façon unique la notification d’événement dans la session active.

  • Expéditeur. Objet qui a généré l’événement. Dans la valeur du paramètre Action, la variable automatique $Sender contient l’objet expéditeur.

  • SourceEventArgs. Premier paramètre dérivé d’EventArgs, s’il existe. Par exemple, dans un événement écoulé du minuteur dans lequel la signature contient l’expéditeur de l’objet de formulaire, Timers.ElapsedEventArgs e, la propriété SourceEventArgs contient la propriété Timers.ElapsedEventArgs. Dans la valeur du paramètre Action, la variable automatique $EventArgs contient cette valeur.

  • SourceArgs. Tous les paramètres de la signature d’événement d’origine. Pour une signature d’événement standard, $Args[0] représente l’expéditeur et $Args[1] représente la SourceEventArgs. Dans la valeur du paramètre Action, la variable automatique $Args contient cette valeur.

  • SourceIdentifier. Chaîne qui identifie l’abonnement aux événements. Dans la valeur du paramètre Action, la propriété SourceIdentifier de la variable automatique $Event contient cette valeur.

  • TimeGenerated. Objet DateTime qui représente l’heure à laquelle l’événement a été généré. Dans la valeur du paramètre Action, la propriété TimeGenerated de la variable automatique $Event contient cette valeur.

  • MessageData. Données associées à l’abonnement aux événements. Les utilisateurs spécifient ces données lorsqu’ils inscrivent un événement. Dans la valeur du paramètre Action, la propriété MessageData de la variable automatique $Event contient cette valeur.