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

Az Get-Event parancsmag az aktuális munkamenethez tartozó Windows PowerShell-eseménysor eseménysorában kapja le az 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, az New-Event parancsmaggal létrehozott eseményeket, valamint a Windows 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 a Get-WinEvent vagy a Get-EventLog parancsot.

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ővel (|) küldi el az eseményt a Format-List parancsnak, amely megjeleníti az esemény összes tulajdonságát egy listában. 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 csövezhet be bemenetet.

Kimenetek

PSEventArgs

Get-Event minden eseményhez egy PSEventArgs 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

  • 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 Művelet 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 (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ó tartalmazza ezt az értéket.

    • ForrásArgs. Az eredeti esemény-aláírás összes paramétere. Normál esemény-aláírás esetén a $Args[0] a feladót, a $Args[1] pedig a SourceEventArgs értéket jelöli. 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 $Event automatikus változó SourceIdentifier 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 $Event automatikus változó TimeGenerated 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 $Event automatikus változó MessageData tulajdonsága tartalmazza ezt az értéket.