Delen via

Get-Event

  • Referentie
Module:
Microsoft.PowerShell.Utility

Haalt de gebeurtenissen op in de gebeurteniswachtrij.

Syntaxis

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

Description

De Get-Event cmdlet haalt gebeurtenissen op in de PowerShell-gebeurteniswachtrij voor de huidige sessie. U kunt alle gebeurtenissen ophalen of de parameter EventIdentifier of SourceIdentifier parameter gebruiken om de gebeurtenissen op te geven.

Wanneer een gebeurtenis plaatsvindt, wordt deze toegevoegd aan de gebeurteniswachtrij. De gebeurteniswachtrij bevat gebeurtenissen waarvoor u zich hebt geregistreerd, gebeurtenissen die zijn gemaakt met behulp van de New-Event-cmdlet en de gebeurtenis die wordt gegenereerd wanneer PowerShell wordt afgesloten. U kunt Get-Event of Wait-Event gebruiken om de gebeurtenissen op te halen.

Met deze cmdlet worden geen gebeurtenissen opgehaald uit de logboeken van Logboeken. Als u deze gebeurtenissen wilt ophalen, gebruikt u Get-WinEvent of Get-EventLog.

Voorbeelden

Voorbeeld 1: Alle gebeurtenissen ophalen

PS C:\> Get-Event

Met deze opdracht worden alle gebeurtenissen in de gebeurteniswachtrij opgehaald.

Voorbeeld 2: Gebeurtenissen ophalen op bron-id

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

Met deze opdracht worden gebeurtenissen opgehaald waarin de waarde van de eigenschap SourceIdentifier PowerShell.ProcessCreated is.

Voorbeeld 3: Een gebeurtenis ophalen op basis van de tijd waarop deze is gegenereerd

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      :

In dit voorbeeld ziet u hoe u gebeurtenissen kunt ophalen met behulp van andere eigenschappen dan SourceIdentifier.

Met de eerste opdracht worden alle gebeurtenissen in de gebeurteniswachtrij opgehaald en opgeslagen in de $Events variabele.

De tweede opdracht maakt gebruik van matrix-notatie om de eerste gebeurtenis (0-index) op te halen in de matrix in de $Events variabele. De opdracht maakt gebruik van een pijplijnoperator (|) om de gebeurtenis te verzenden naar de opdracht Format-List, waarin alle eigenschappen van de gebeurtenis in een lijst worden weergegeven. Hiermee kunt u de eigenschappen van het gebeurtenisobject onderzoeken.

De derde opdracht laat zien hoe u de Where-Object-cmdlet gebruikt om een gebeurtenis op te halen op basis van de tijd waarop deze is gegenereerd.

Voorbeeld 4: Een gebeurtenis ophalen op de id

PS C:\> Get-Event -EventIdentifier 2

Met deze opdracht wordt de gebeurtenis met een gebeurtenis-id van 2 geretourneerd.

Parameters

-EventIdentifier

Hiermee geeft u de gebeurtenis-id's waarvoor deze cmdlet gebeurtenissen ophaalt.

Type:Int32
Aliassen:Id
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-SourceIdentifier

Hiermee geeft u bron-id's op waarvoor deze cmdlet gebeurtenissen ophaalt. De standaardwaarde is alle gebeurtenissen in de gebeurteniswachtrij. Jokertekens zijn niet toegestaan.

Type:String
Position:0
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

Invoerwaarden

None

U kunt geen objecten doorsluisen naar deze cmdlet.

Uitvoerwaarden

PSEventArgs

Deze cmdlet retourneert een PSEventArgs--object voor elke gebeurtenis. Als u een beschrijving van dit object wilt zien, typt u Get-Help Get-Event -Full en bekijkt u de sectie Notities van het Help-onderwerp.

Notities

Er zijn geen gebeurtenisbronnen beschikbaar op de Linux- of macOS-platforms.

Gebeurtenissen, gebeurtenisabonnementen en de gebeurteniswachtrij bestaan alleen in de huidige sessie. Als u de huidige sessie sluit, wordt de gebeurteniswachtrij verwijderd en wordt het gebeurtenisabonnement geannuleerd.

De cmdlet Get-Event retourneert een PSEventArgs-object (System.Management.Automation.PSEventArgs) met de volgende eigenschappen:

  • Computernaam. De naam van de computer waarop de gebeurtenis heeft plaatsgevonden. Deze eigenschapswaarde wordt alleen ingevuld wanneer de gebeurtenis wordt doorgestuurd vanaf een externe computer.

  • RunspaceId. Een GUID die de sessie waarin de gebeurtenis is opgetreden, uniek identificeert. Deze eigenschapswaarde wordt alleen ingevuld wanneer de gebeurtenis wordt doorgestuurd vanaf een externe computer.

  • EventIdentifier. Een geheel getal (Int32) dat de gebeurtenismelding uniek identificeert in de huidige sessie.

  • Afzender. Het object dat de gebeurtenis heeft gegenereerd. In de waarde van de parameter Action bevat de $Sender automatische variabele het afzenderobject.

  • SourceEventArgs. De eerste parameter die is afgeleid van EventArgs, als deze bestaat. Bijvoorbeeld, in een timer verstreken gebeurtenis waarin de handtekening de afzender van het formulier object heeft, Timers.ElapsedEventArgs e, de eigenschap SourceEventArgs bevat de Timers.ElapsedEventArgs. In de waarde van de parameter Action bevat de $EventArgs automatische variabele deze waarde.

  • SourceArgs. Alle parameters van de oorspronkelijke gebeurtenishandtekening. Voor een standaard gebeurtenishandtekening vertegenwoordigt $Args[0] de afzender en $Args[1] de SourceEventArgs. In de waarde van de parameter Action bevat de $Args automatische variabele deze waarde.

  • SourceIdentifier. Een tekenreeks die het gebeurtenisabonnement identificeert. In de waarde van de parameter Action bevat de eigenschap SourceIdentifier van de automatische variabele $Event deze waarde.

  • TimeGenerated. Een DateTime--object dat het tijdstip aangeeft waarop de gebeurtenis is gegenereerd. In de waarde van de parameter Action bevat de eigenschap TimeGenerated van de automatische variabele $Event deze waarde.

  • MessageData. Gegevens die zijn gekoppeld aan het gebeurtenisabonnement. Gebruikers geven deze gegevens op wanneer ze een gebeurtenis registreren. In de waarde van de parameter Action bevat de eigenschap MessageData van de automatische variabele $Event deze waarde.