Remove-Event (Microsoft.PowerShell.Utility)

Remove-Event

Modül:: Microsoft.PowerShell.Utility

Olay kuyruğundan olayları siler.

Sözdizimi

Remove-Event
      [-SourceIdentifier] <String>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-Event
      [-EventIdentifier] <Int32>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Tanım

Remove-Event cmdlet'i, geçerli oturumdaki olay kuyruğundan olayları siler.

Bu cmdlet yalnızca şu anda kuyrukta bulunan olayları siler. Etkinlik kayıtlarını iptal etmek veya abonelikten çıkmak için Unregister-Event cmdlet'ini kullanın.

Örnekler

Örnek 1: Bir etkinliği kaynak tanımlayıcıya göre kaldırma

PS C:\> Remove-Event -SourceIdentifier "ProcessStarted"

Bu komut, olay kuyruğundan İşlem Başlatıldı kaynak tanımlayıcısına sahip olayları siler.

Örnek 2: Bir etkinliği etkinlik tanımlayıcısına göre kaldırma

PS C:\> Remove-Event -EventIdentifier 30

Bu komut, olay kimliği 30 olan olayı olay kuyruğundan siler.

Örnek 3: Tüm etkinlikleri kaldırın

PS C:\> Get-Event | Remove-Event

Bu komut, olay kuyruğundaki tüm olayları siler.

Parametreler

-Confirm

Cmdlet'i çalıştırmadan önce sizden onay ister.

Tip :: SwitchParameter
Takma adlar:: cf
Konum:: Adlandırılmış
Varsayılan değer:: False
Gerekli:: False
Boru hattı girişini kabul edin:: False
Joker karakterleri kabul et:: False

-EventIdentifier

Cmdlet'in silindiği olay tanımlayıcısını belirtir. Her komutta bir EventIdentifier veya SourceIdentifier parametresi gereklidir.

Tip :: Int32
Konum:: 0
Varsayılan değer:: None
Gerekli:: True
Boru hattı girişini kabul edin:: True
Joker karakterleri kabul et:: False

-SourceIdentifier

Bu cmdlet'in olayları sildiği kaynak tanımlayıcıyı belirtir. Joker karakterlere izin verilmez. Her komutta bir EventIdentifier veya SourceIdentifier parametresi gereklidir.

Tip :: String
Konum:: 0
Varsayılan değer:: None
Gerekli:: True
Boru hattı girişini kabul edin:: False
Joker karakterleri kabul et:: False

-WhatIf

Cmdlet çalıştırılırsa ne olacağını gösterir. Cmdlet çalıştırılmıyor.

Tip :: SwitchParameter
Takma adlar:: wi
Konum:: Adlandırılmış
Varsayılan değer:: False
Gerekli:: False
Boru hattı girişini kabul edin:: False
Joker karakterleri kabul et:: False

Girişler

PSEventArgs

Olayları Get-Event'ten bu cmdlet'e aktarabilirsiniz.

Çıkışlar

Yok

Bu cmdlet hiçbir çıktı döndürmez.

Notlar

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

Etkinlikler, etkinlik abonelikleri ve olay kuyruğu yalnızca geçerli oturumda mevcuttur. Geçerli oturumu kapatırsanız etkinlik kuyruğu atılır ve etkinlik aboneliği iptal edilir.