Aracılığıyla paylaş

Unregister-Event

  • Başvuru
Modül:
Microsoft.PowerShell.Utility

Olay aboneliğini iptal eder.

Syntax

Unregister-Event
          [-SourceIdentifier] <String>
          [-Force]
          [-WhatIf]
          [-Confirm]
          [<CommonParameters>]
Unregister-Event
          [-SubscriptionId] <Int32>
          [-Force]
          [-WhatIf]
          [-Confirm]
          [<CommonParameters>]

Description

cmdlet'i Unregister-Event , Register-ObjectEventveya Register-WmiEvent cmdlet'i kullanılarak oluşturulan bir olay aboneliğini Register-EngineEventiptal eder.

Bir olay aboneliği iptal edildiğinde, olay abonesi oturumdan silinir ve abone olunan olaylar artık olay kuyruğuna eklenmez. cmdlet'ini kullanarak New-Event oluşturulan bir olaya aboneliği iptal ettiğinizde, yeni olay da oturumdan silinir.

Unregister-Event olay kuyruğundan olayları silmez. Olayları silmek için cmdlet'ini Remove-Event kullanın.

Örnekler

Örnek 1: Olay aboneliğini kaynak tanımlayıcıya göre iptal etme

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

Bu komut, ProcessStarted kaynak tanımlayıcısı olan olay aboneliğini iptal eder.

Bir olayın kaynak tanımlayıcısını bulmak için cmdlet'ini Get-Event kullanın. Olay aboneliğinin kaynak tanımlayıcısını bulmak için cmdlet'ini Get-EventSubscriber kullanın.

Örnek 2: Olay aboneliğini abonelik tanımlayıcısı ile iptal etme

PS C:\> Unregister-Event -SubscriptionId 2

Bu komut, abonelik tanımlayıcısı 2 olan olay aboneliğini iptal eder.

Bir olay aboneliğinin abonelik tanımlayıcısını bulmak için cmdlet'ini Get-EventSubscriber kullanın.

Örnek 3: Tüm olay aboneliklerini iptal etme

PS C:\> Get-EventSubscriber -Force | Unregister-Event -Force

Bu komut oturumdaki tüm olay aboneliklerini iptal eder.

komut, olay kaydı cmdlet'lerinin SupportEvent parametresi kullanılarak gizlenmiş aboneler de dahil olmak üzere oturumdaki tüm olay abonesi nesnelerini almak için cmdlet'ini kullanırGet-EventSubscriber.

Abone nesnelerini Unregister-Eventadresine göndermek için bir işlem hattı işleci (|) kullanır ve bu da bunları oturumdan siler. Görevi tamamlamak için üzerinde Force parametresi de gereklidir Unregister-Event.

Parametreler

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

, Register-WmiEventve Register-EngineEvent'nin SupportEvent parametresi kullanılarak gizlenen abonelikler de dahil olmak üzere tüm olay aboneliklerini Register-ObjectEventiptal eder.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SourceIdentifier

Bu cmdlet'in olay aboneliklerini iptal ettiğini belirten bir kaynak tanımlayıcı belirtir.

Her komuta bir SourceIdentifier veya SubscriptionId parametresi eklenmelidir.

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

-SubscriptionId

Bu cmdlet'in olay aboneliklerini iptal ettiğini belirten bir kaynak tanımlayıcı kimliği belirtir.

Her komuta bir SourceIdentifier veya SubscriptionId parametresi eklenmelidir.

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

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Girişler

PSEventSubscriber

çıkışını öğesine Get-EventSubscriberUnregister-Eventyöneltebilirsiniz.

Çıkışlar

None

Bu cmdlet herhangi bir çı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.

Unregister-Event cmdlet'ini New-Event kullanarak olaya abone olmadıkça cmdlet'i kullanılarak Register-EngineEvent oluşturulan olayları silemez. Özel bir olayı oturumdan silmek için, bunu program aracılığıyla kaldırmanız veya oturumu kapatmanız gerekir.