Get-Event

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

Obtient les événements présents dans la file d'attente des événements.

Syntax

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

Description

L’applet Get-Event de commande 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.

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

Cette applet de commande n'obtient pas les événements 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 des é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 d'autres propriétés que SourceIdentifier.

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

La deuxième commande utilise la notation de tableau pour obtenir le premier événement (0-index) dans le tableau de la $Events variable. La commande utilise un opérateur de pipeline (|) pour envoyer l’événement à la Format-List commande, 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 Where-Object de commande 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 ayant l'identificateur d'événement 2.

Paramètres

-EventIdentifier

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

Type:Int32
Aliases:Id
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-SourceIdentifier

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

Type:String
Position:0
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

Entrées

None

Vous ne pouvez pas diriger les objets vers cette applet de commande.

Sorties

PSEventArgs

Cette applet de commande 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 cette session, la file d'attente d'événements est ignorée et l'abonnement aux événements est annulé.

L’applet Get-Event de commande 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. La valeur de cette propriété est renseignée uniquement quand 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. La valeur de cette propriété est renseignée uniquement quand l'événement est transféré à partir d'un ordinateur distant.

  • EventIdentifier. entier (Int32) qui identifie de façon unique la notification d'événements dans la session active.

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

  • SourceEventArgs. premier paramètre qui dérive d'EventArgs, s'il existe. Par exemple, dans un événement écoulé du minuteur dans lequel la signature a l’expéditeur de l’objet de formulaire, Timers.ElapsedEventArgs e, la propriété SourceEventArgs contiendrait timers.ElapsedEventArgs. Dans la valeur du paramètre Action , la $EventArgs variable automatique 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 SourceEventArgs. Dans la valeur du paramètre Action , la $Args variable automatique contient cette valeur.

  • SourceIdentifier. chaîne qui identifie l'abonnement à l'événement. Dans la valeur du paramètre Action , la propriété SourceIdentifier de la $Event variable automatique 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 $Event variable automatique contient cette valeur.

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