Megosztás a következőn keresztül:

Get-Event

Modul:
Microsoft.PowerShell.Utility Module

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

Syntax

BySource (Alapértelmezett) 

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

ById 

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

Description

A Get-Event parancsmag lekéri az aktuális munkamenet PowerShell-eseménysorában lévő eseményeket. Az események megadásához lekérheti az összes eseményt, vagy használhatja az EventIdentifier vagy SourceIdentifier paramétert.

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 parancsmaggal létrehozott eseményeket, valamint a PowerShell kilépésekor létrejött eseményt. Az események lekéréséhez használhatja Get-Event vagy Wait-Event.

Ez a parancsmag nem kap eseményeket az Eseménynapló naplóibó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 az első (0 indexes) esemény lekéréséhez a tömbben a $Events változóban. A parancs egy folyamatkezelő (|) használatával 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.

Paramétertulajdonságok

Típus:Int32
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False
Aliasok:Id

Paraméterkészletek

ById
Position:0
Kötelező:True
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:True
Fennmaradó argumentumokból származó érték: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.

Paramétertulajdonságok

Típus:String
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

BySource
Position:0
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:True
Fennmaradó argumentumokból származó érték:False

CommonParameters

Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.

Bevitelek

None

Ehhez a parancsmaghoz nem lehet objektumokat csövezni.

Kimenetek

PSEventArgs

Ez a parancsmag egy PSEventArgs objektumot ad vissza minden eseményhez. 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

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 PSEventArgs objektumot (System.Management.Automation.PSEventArgs) 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.

  • Eseményazonosító. 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 Action paraméter értékében a $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 űrlapot tartalmazza, Timers.ElapsedEventArgs e, a SourceEventArgs tulajdonság tartalmazza az Timers.ElapsedEventArgs. A Művelet paraméter értékében az $EventArgs automatikus változó tartalmazza ezt az értéket.

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

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

  • TimeGenerated elemre. Egy DateTime objektum, amely az esemény létrehozásának időpontját jelöli. A Action paraméter értékében az automatikus változó $Event tulajdonsága tartalmazza ezt az é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ó $Event tulajdonsága tartalmazza ezt az értéket.