Unregister-Event
Olay aboneliğini iptal eder.
Sözdizimi
BySource EnterprisePublishing
Unregister-Event
[-SourceIdentifier] <String>
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ById
Unregister-Event
[-SubscriptionId] <Int32>
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Unregister-Event cmdlet'i, Register-EngineEvent, Register-ObjectEventveya Register-WmiEvent cmdlet'i kullanılarak oluşturulan bir olay aboneliğini iptal eder.
Olay aboneliği iptal edildiğinde, olay abonesi oturumdan silinir ve abone olunan olaylar artık olay kuyruğuna eklenmez.
New-Event cmdlet'ini kullanarak 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 Remove-Event cmdlet'ini kullanın.
Örnekler
Örnek 1: Olay aboneliğini kaynak tanımlayıcıya göre iptal etme
Bu komut, ProcessStarted kaynak tanımlayıcısı olan olay aboneliğini iptal eder.
Unregister-Event -SourceIdentifier "ProcessStarted"
Bir olayın kaynak tanımlayıcısını bulmak için Get-Event cmdlet'ini kullanın. Olay aboneliğinin kaynak tanımlayıcısını bulmak için Get-EventSubscriber cmdlet'ini kullanın
Örnek 2: Olay aboneliğini abonelik tanımlayıcısı ile iptal etme
Bu komut, abonelik tanımlayıcısı 2 olan olay aboneliğini iptal eder.
Unregister-Event -SubscriptionId 2
Olay aboneliğinin abonelik tanımlayıcısını bulmak için Get-EventSubscriber cmdlet'ini kullanın.
Örnek 3: Tüm olay aboneliklerini iptal etme
Bu örnek, oturumdaki tüm olay aboneliklerini iptal eder.
Get-EventSubscriber -Force | Unregister-Event -Force
ile Get-EventSubscriber parametresini kullanmak, gizli olan aboneler de dahil olmak üzere oturumdaki tüm olay abonesi nesnelerini alır. Çıkış, aboneleri oturumdan silen Unregister-Eventadresine yöneltilir. gizli aboneleri kaldırmak için Unregister-Event parametresi gereklidir.
Parametreler
-Confirm
Cmdlet'i çalıştırmadan önce sizden onay ister.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | False |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | Cf |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Force
, Register-ObjectEventve Register-WmiEventRegister-EngineEvent parametresi kullanılarak gizlenen abonelikler de dahil olmak üzere tüm olay aboneliklerini iptal eder.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-SourceIdentifier
Bu cmdlet'in olay aboneliklerini iptal ettiğini belirten bir kaynak tanımlayıcı belirtir.
SourceIdentifier veya SubscriptionId parametresi her komuta eklenmelidir.
Parametre özellikleri
| Tür: | String |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
BySource
| 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 |
-SubscriptionId
Bu cmdlet'in olay aboneliklerini iptal ettiğini belirten bir kaynak tanımlayıcı kimliği belirtir.
SourceIdentifier veya SubscriptionId parametresi her komuta eklenmelidir.
Parametre özellikleri
| Tür: | Int32 |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
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 |
-WhatIf
Cmdlet çalıştırılırsa ne olacağını gösterir. Cmdlet çalıştırılmaz.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | False |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | Wi |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| 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
PSEventSubscriber
çıkışı Get-EventSubscriber bu cmdlet'e 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. Mevcut oturumu kapatırsanız, etkinlik kuyruğu silinir ve etkinlik aboneliği iptal edilir.
Unregister-Event, New-Event cmdlet'ini kullanarak olaya abone olmadıkça Register-EngineEvent cmdlet'i kullanılarak oluşturulan olayları silemez. Özel bir olayı oturumdan silmek için, bunu program aracılığıyla kaldırmanız veya oturumu kapatmanız gerekir.
