Get-Event

  • Referensi
Modul:
Microsoft.PowerShell.Utility

Mendapatkan peristiwa dalam antrean peristiwa.

Sintaks

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

Deskripsi

Get-Event Cmdlet mendapatkan peristiwa dalam antrean peristiwa PowerShell untuk sesi saat ini. Anda bisa mendapatkan semua peristiwa atau menggunakan parameter EventIdentifier atau SourceIdentifier untuk menentukan peristiwa.

Saat peristiwa terjadi, peristiwa ditambahkan ke antrean peristiwa. Antrean peristiwa mencakup peristiwa yang telah Anda daftarkan, peristiwa yang dibuat dengan menggunakan New-Event cmdlet, dan peristiwa yang dinaikkan saat PowerShell keluar. Anda dapat menggunakan Get-Event atau Wait-Event untuk mendapatkan peristiwa.

Cmdlet ini tidak mendapatkan peristiwa dari log Pemantau Peristiwa. Untuk mendapatkan peristiwa tersebut, gunakan Get-WinEvent atau Get-EventLog.

Contoh

Contoh 1: Dapatkan semua peristiwa

PS C:\> Get-Event

Perintah ini mendapatkan semua peristiwa dalam antrean peristiwa.

Contoh 2: Mendapatkan peristiwa menurut pengidentifikasi sumber

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

Perintah ini mendapatkan peristiwa di mana nilai properti SourceIdentifier adalah PowerShell.ProcessCreated.

Contoh 3: Dapatkan peristiwa berdasarkan waktu pembuatannya

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      :

Contoh ini menunjukkan cara mendapatkan peristiwa dengan menggunakan properti selain SourceIdentifier.

Perintah pertama mendapatkan semua peristiwa dalam antrean peristiwa dan menyimpannya dalam $Events variabel.

Perintah kedua menggunakan notasi array untuk mendapatkan peristiwa (0-indeks) pertama dalam array dalam $Events variabel. Perintah menggunakan operator alur (|) untuk mengirim peristiwa ke Format-List perintah, yang menampilkan semua properti peristiwa dalam daftar. Ini memungkinkan Anda untuk memeriksa properti objek peristiwa.

Perintah ketiga menunjukkan cara menggunakan Where-Object cmdlet untuk mendapatkan peristiwa berdasarkan waktu pembuatannya.

Contoh 4: Mendapatkan peristiwa berdasarkan pengidentifikasinya

PS C:\> Get-Event -EventIdentifier 2

Perintah ini mendapatkan peristiwa dengan pengidentifikasi peristiwa 2.

Parameter

-EventIdentifier

Menentukan pengidentifikasi peristiwa tempat cmdlet ini mendapatkan peristiwa.

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

-SourceIdentifier

Menentukan pengidentifikasi sumber tempat cmdlet ini mendapatkan peristiwa. Defaultnya adalah semua peristiwa dalam antrean peristiwa. Kartubebas tidak diizinkan.

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

Input

None

Anda tidak dapat menyalurkan objek ke cmdlet ini.

Output

PSEventArgs

Cmdlet ini mengembalikan objek PSEventArgs untuk setiap peristiwa. Untuk melihat deskripsi objek ini, ketik Get-Help Get-Event -Full dan lihat bagian Catatan dari topik bantuan.

Catatan

Tidak ada sumber peristiwa yang tersedia di platform Linux atau macOS.

Peristiwa, langganan peristiwa, dan antrean peristiwa hanya ada di sesi saat ini. Jika Anda menutup sesi saat ini, antrean peristiwa akan dibuang dan langganan acara dibatalkan.

Get-Event Cmdlet mengembalikan objek PSEventArgs (System.Management.Automation.PSEventArgs) dengan properti berikut:

  • ComputerName. Nama komputer tempat peristiwa terjadi. Nilai properti ini diisi hanya ketika peristiwa diteruskan dari komputer jarak jauh.

  • RunspaceId. GUID yang secara unik mengidentifikasi sesi tempat peristiwa terjadi. Nilai properti ini diisi hanya ketika peristiwa diteruskan dari komputer jarak jauh.

  • EventIdentifier. Bilangan bulat (Int32) yang secara unik mengidentifikasi pemberitahuan peristiwa dalam sesi saat ini.

  • Pengirim. Objek yang menghasilkan peristiwa. Dalam nilai parameter Tindakan , $Sender variabel otomatis berisi objek pengirim.

  • SourceEventArgs. Parameter pertama yang berasal dari EventArgs, jika ada. Misalnya, dalam peristiwa timer yang berlalu di mana tanda tangan memiliki formulir Pengirim objek, Timers.ElapsedEventArgs e, properti SourceEventArgs akan berisi Timers.ElapsedEventArgs. Dalam nilai parameter Tindakan , $EventArgs variabel otomatis berisi nilai ini.

  • SourceArgs. Semua parameter tanda tangan peristiwa asli. Untuk tanda tangan peristiwa standar, $Args[0] mewakili pengirim, dan $Args[1] mewakili SourceEventArgs. Dalam nilai parameter Tindakan , $Args variabel otomatis berisi nilai ini.

  • SourceIdentifier. String yang mengidentifikasi langganan peristiwa. Dalam nilai parameter Tindakan , properti SourceIdentifier dari $Event variabel otomatis berisi nilai ini.

  • TimeGenerated. Objek DateTime yang mewakili waktu di mana peristiwa dibuat. Dalam nilai parameter Tindakan , properti TimeGenerated dari $Event variabel otomatis berisi nilai ini.

  • MessageData. Data yang terkait dengan langganan peristiwa. Pengguna menentukan data ini saat mereka mendaftarkan peristiwa. Dalam nilai parameter Tindakan , properti MessageData dari $Event variabel otomatis berisi nilai ini.