Get-Event

Modül:
Microsoft.PowerShell.Utility Module

Olay kuyruğundaki olayları alır.

Syntax

BySource (Varsayılan) 

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

ById 

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

Description

Get-Event cmdlet'i geçerli oturum için PowerShell olay kuyruğundaki olayları alır. Olayları belirtmek için tüm olayları alabilir veya EventIdentifier veya SourceIdentifier parametresini kullanabilirsiniz.

Bir olay oluştuğunda, olay kuyruğuna eklenir. Olay kuyruğu, kaydettiğiniz olayları, New-Event cmdlet'i kullanılarak oluşturulan olayları ve PowerShell'in çıkışında oluşturulan olayı içerir. Olayları almak için Get-Event veya Wait-Event kullanabilirsiniz.

Bu cmdlet Olay Görüntüleyicisi günlüklerinden olay almaz. Bu olayları almak için Get-WinEvent veya Get-EventLogkullanın.

Örnekler

Örnek 1: Tüm olayları alma

PS C:\> Get-Event

Bu komut olay kuyruğundaki tüm olayları alır.

Örnek 2: Kaynak tanımlayıcıya göre olayları alma

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

Bu komut, SourceIdentifier özelliğinin değerinin PowerShell.ProcessCreated olduğu olayları alır.

Örnek 3: Bir olayı oluşturulduğu zamana göre alma

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      :

Bu örnekte SourceIdentifier dışındaki özellikleri kullanarak olayların nasıl alınacağı gösterilmektedir.

İlk komut olay kuyruğundaki tüm olayları alır ve bunları $Events değişkenine kaydeder.

İkinci komut, dizideki ilk (0-index) olayı $Events değişkeninde almak için dizi gösterimini kullanır. komut, olayı | komutuna göndermek için bir işlem hattı işleci (Format-List) kullanır ve bu komut olayın tüm özelliklerini bir listede görüntüler. Bu, olay nesnesinin özelliklerini incelemenize olanak tanır.

Üçüncü komut, Where-Object cmdlet'ini kullanarak olayın oluşturulduğu zamana göre nasıl alındığını gösterir.

Örnek 4: Tanımlayıcısına göre olay alma

PS C:\> Get-Event -EventIdentifier 2

Bu komut olayı 2 olay tanımlayıcısıyla alır.

Parametreler

-EventIdentifier

Bu cmdlet'in olayları aldığı olay tanımlayıcılarını belirtir.

Parametre özellikleri

Tür:Int32
Default value:None
Joker karakterleri destekler:False
DontShow:False
Diğer adlar:Kimlik

Parametre kümeleri

ById
Position:0
Zorunlu:True
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:True
Kalan bağımsız değişkenlerden elde edilen değer:False

-SourceIdentifier

Bu cmdlet'in olayları aldığı kaynak tanımlayıcıları belirtir. Varsayılan değer, olay kuyruğundaki tüm olaylardır. Joker karakterlere izin verilmez.

Parametre özellikleri

Tür:String
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

BySource
Position:0
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:True
Kalan bağımsız değişkenlerden elde edilen değer:False

CommonParameters

Bu cmdlet yaygın parametreleri destekler: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction ve -WarningVariable. Daha fazla bilgi için bkz. about_CommonParameters.

Girişler

None

Nesneleri bu cmdlet'e yöneltemezsiniz.

Çıkışlar

PSEventArgs

Bu cmdlet her olay için bir PSEventArgs nesnesi döndürür. Bu nesnenin açıklamasını görmek için Get-Help Get-Event -Full yazın ve yardım konusunun Notlar bölümüne bakın.

Notlar

Linux veya macOS platformlarında kullanılabilir olay kaynağı yok.

Olaylar, olay abonelikleri ve olay kuyruğu yalnızca geçerli oturumda bulunur. Mevcut oturumu kapatırsanız, etkinlik kuyruğu silinir ve etkinlik aboneliği iptal edilir.

Get-Event cmdlet aşağıdaki özelliklere sahip bir PSEventArgs nesnesi (System.Management.Automation.PSEventArgs) döndürür:

  • ComputerName. Olayın gerçekleştiği bilgisayarın adı. Bu özellik değeri yalnızca olay uzak bir bilgisayardan iletildiğinde doldurulur.

  • RunspaceId komutunu kullanın. Olayın oluştuğu oturumu benzersiz olarak tanımlayan GUID. Bu özellik değeri yalnızca olay uzak bir bilgisayardan iletildiğinde doldurulur.

  • Olay Tanımlayıcısı. Geçerli oturumdaki olay bildirimini benzersiz olarak tanımlayan bir tamsayı (Int32).

  • Gönderen. Olayı oluşturan nesne. Eylemi parametresinin değerinde, $Sender otomatik değişkeni gönderen nesnesini içerir.

  • SourceEventArgs olarak adlandırılır. Varsa EventArgs'ten türetilen ilk parametre. Örneğin, imzanın Nesne göndereni Timers.ElapsedEventArgs e biçiminde olduğu süreölçerde SourceEventArgs özelliği Timers.ElapsedEventArgsiçerebilir. Eylem parametresinin değerinde, $EventArgs otomatik değişkeni bu değeri içerir.

  • KaynakArgs. Özgün olay imzasının tüm parametreleri. Standart olay imzası için $args[0] göndereni, $args[1]SourceEventArgstemsil eder. Eylem parametresinin değerinde, $args otomatik değişkeni bu değeri içerir.

  • SourceIdentifier öğesini seçin. Olay aboneliğini tanımlayan dize. Eylemi parametresinin değerinde, otomatik değişkeninin $Event özelliği bu değeri içerir.

  • TimeGenerated. Olayın oluşturulduğu saati temsil eden bir DateTime nesnesi. Eylemi parametresinin değerinde, otomatik değişkeninin $Event özelliği bu değeri içerir.

  • MessageData. Olay aboneliğiyle ilişkili veriler. Kullanıcılar bir olayı kaydederken bu verileri belirtir. Eylemi parametresinin değerinde, otomatik değişkeninin $Event özelliği bu değeri içerir.