Aracılığıyla paylaş

Remove-Event

  • Başvuru
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>]

Description

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

Bu cmdlet yalnızca şu anda kuyrukta olan olayları siler. Olay kayıtlarını iptal etmek veya aboneliği kaldırmak için cmdlet'ini Unregister-Event kullanın.

Örnekler

Örnek 1: Kaynak tanımlayıcıya göre bir olayı kaldırma

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

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

Örnek 2: Olay tanımlayıcısı ile olayı kaldırma

PS C:\> Remove-Event -EventIdentifier 30

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

Örnek 3: Tüm olayları kaldırma

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.

Tür:SwitchParameter
Diğer adlar:cf
Position:Named
Default value:False
Gerekli:False
İşlem hattı girişini kabul et: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 gerekir.

Tür:Int32
Position:0
Default value:None
Gerekli:True
İşlem hattı girişini kabul et: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 gerekir.

Tür:String
Position:0
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-WhatIf

Cmdlet çalıştırılıyorsa ne olacağını gösterir. Cmdlet çalıştırılmaz.

Tür:SwitchParameter
Diğer adlar:wi
Position:Named
Default value:False
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

Girişler

PSEventArgs

Olayları bu cmdlet'e Get-Event yöneltebilirsiniz.

Çıkışlar

None

Bu cmdlet çıkış döndürmez.

Notlar

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

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