Get-Event

  • Referencia
Modul:
Microsoft.PowerShell.Utility

Lekéri az eseményeket az eseménysoron.

Syntax

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

Description

A Get-Event parancsmag lekéri az aktuális munkamenet PowerShell-eseménysorában lévő eseményeket. Lekérheti az összes eseményt, vagy az EventIdentifier vagy a SourceIdentifier paraméter használatával megadhatja az eseményeket.

Amikor egy esemény bekövetkezik, a rendszer hozzáadja azt az eseménysorhoz. Az eseménysor tartalmazza azokat az eseményeket, amelyekre regisztrált, a New-Event parancsmag használatával létrehozott eseményeket, valamint a PowerShell kilépésekor létrejött eseményt. Használhatja Get-Event vagy Wait-Event lekérheti az eseményeket.

Ez a parancsmag nem kap eseményeket a Eseménynapló naplókból. Az események lekéréséhez használja Get-WinEvent vagy Get-EventLog.

Példák

1. példa: Az összes esemény lekérése

PS C:\> Get-Event

Ez a parancs lekéri az eseménysor összes eseményét.

2. példa: Események lekérése forrásazonosító alapján

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

Ez a parancs lekéri azokat az eseményeket, amelyekben a SourceIdentifier tulajdonság értéke PowerShell.ProcessCreated.

3. példa: Esemény lekérése a létrehozás időpontja alapján

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      :

Ez a példa bemutatja, hogyan kérhet le eseményeket a SourceIdentifier tulajdonságtól eltérő tulajdonságok használatával.

Az első parancs lekéri az eseménysor összes eseményét, és menti őket a $Events változóba.

A második parancs tömbjelezést használ a változó tömbjének első (0 indexes) eseményének lekéréséhez $Events . A parancs egy folyamatkezelővel (|) küldi el az eseményt a Format-List parancsnak, amely egy listában jeleníti meg az esemény összes tulajdonságát. Ez lehetővé teszi az eseményobjektum tulajdonságainak vizsgálatát.

A harmadik parancs bemutatja, hogyan használhatja a Where-Object parancsmagot egy esemény lekérésére a létrehozás időpontja alapján.

4. példa: Esemény lekérése az azonosító alapján

PS C:\> Get-Event -EventIdentifier 2

Ez a parancs lekéri az eseményt 2 eseményazonosítóval.

Paraméterek

-EventIdentifier

Megadja azokat az eseményazonosítókat, amelyekhez ez a parancsmag eseményeket kér le.

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

-SourceIdentifier

Megadja azokat a forrásazonosítókat, amelyekhez ez a parancsmag eseményeket kér le. Az alapértelmezett érték az eseménysor összes eseménye. Helyettesítő karakterek használata nem engedélyezett.

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

Bevitelek

None

Ehhez a parancsmaghoz nem lehet objektumokat csövezni.

Kimenetek

PSEventArgs

Ez a parancsmag minden eseményhez egy P Standard kiadás ventArgs objektumot ad vissza. Az objektum leírásának megtekintéséhez írja be Get-Help Get-Event -Full és tekintse meg a súgótémakör Jegyzetek szakaszát.

Jegyzetek

Linux vagy macOS platformokon nem érhetők el eseményforrások.

Az események, az esemény-előfizetések és az eseménysor csak az aktuális munkamenetben léteznek. Ha bezárja az aktuális munkamenetet, a rendszer elveti az eseménysort, és megszakítja az esemény-előfizetést.

A Get-Event parancsmag egy P Standard kiadás ventArgs objektumot (System.Management.Automation.P Standard kiadás ventArgs) ad vissza a következő tulajdonságokkal:

  • Számítógépnév. Annak a számítógépnek a neve, amelyen az esemény történt. Ezt a tulajdonságértéket csak akkor tölti ki a rendszer, ha az eseményt távoli számítógépről továbbítják.

  • RunspaceId. Egy GUID, amely egyedileg azonosítja azt a munkamenetet, amelyben az esemény történt. Ezt a tulajdonságértéket csak akkor tölti ki a rendszer, ha az eseményt távoli számítógépről továbbítják.

  • EventIdentifier. Egész szám (Int32), amely egyedileg azonosítja az eseményértesítést az aktuális munkamenetben.

  • Feladó. Az eseményt létrehozó objektum. A Művelet paraméter értékében az $Sender automatikus változó tartalmazza a feladó objektumot.

  • SourceEventArgs. Az EventArgsből származó első paraméter, ha létezik. Egy eltelt időzítőeseményben például, amelyben az aláírás az Objektum feladója (Timers.ElapsedEventArgs e) űrlapot tartalmazza, a SourceEventArgs tulajdonság a Timers.ElapsedEventArgs tulajdonságot tartalmazza. A Művelet paraméter értékében az $EventArgs automatikus változó ezt az értéket tartalmazza.

  • SourceArgs. Az eredeti esemény-aláírás összes paramétere. Normál eseményaadvány $Args[0] esetén a feladót és $Args[1] a SourceEventArgset jelöli. A Művelet paraméter értékében az $Args automatikus változó ezt az értéket tartalmazza.

  • SourceIdentifier. Az esemény-előfizetést azonosító sztring. A Művelet paraméter értékében az automatikus változó SourceIdentifier tulajdonsága tartalmazza ezt az $Event értéket.

  • TimeGenerated. DateTime-objektum, amely az esemény létrehozásának időpontját jelöli. A Művelet paraméter értékében az automatikus változó TimeGenerated tulajdonsága tartalmazza ezt az $Event értéket.

  • MessageData. Az esemény-előfizetéshez társított adatok. A felhasználók az esemény regisztrálásakor adják meg ezeket az adatokat. A Művelet paraméter értékében az automatikus változó MessageData tulajdonsága tartalmazza ezt az $Event értéket.