Unregister-Event
Megszakít egy esemény-előfizetést.
Syntax
Unregister-Event
[-SourceIdentifier] <String>
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Unregister-Event
[-SubscriptionId] <Int32>
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
A Unregister-Event
parancsmag megszakítja a , Register-ObjectEvent
vagy Register-WmiEvent
parancsmag használatával Register-EngineEvent
létrehozott esemény-előfizetést.
Az esemény-előfizetés lemondása után az esemény-előfizető törlődik a munkamenetből, és a feliratkozott események már nem lesznek hozzáadva az eseménysorhoz. Amikor lemond egy előfizetést egy, a New-Event
parancsmag használatával létrehozott eseményre, az új esemény is törlődik a munkamenetből.
Unregister-Event
nem törli az eseményeket az eseménysorból. Az események törléséhez használja a Remove-Event
parancsmagot.
Példák
1. példa: Esemény-előfizetés lemondása forrásazonosító alapján
Ez a parancs megszakítja a ProcessStarted forrásazonosítójával rendelkező esemény-előfizetést.
Unregister-Event -SourceIdentifier "ProcessStarted"
Az esemény forrásazonosítójának megkereséséhez használja a Get-Event
parancsmagot. Az esemény-előfizetés forrásazonosítójának megkereséséhez használja a Get-EventSubscriber
parancsmagot
2. példa: Esemény-előfizetés lemondása előfizetés-azonosító alapján
Ez a parancs megszakítja a 2 előfizetési azonosítóval rendelkező esemény-előfizetést.
Unregister-Event -SubscriptionId 2
Egy esemény-előfizetés előfizetés-azonosítójának megkereséséhez használja a Get-EventSubscriber
parancsmagot.
3. példa: Az összes esemény-előfizetés lemondása
Ez a példa megszakítja a munkamenet összes esemény-előfizetését.
Get-EventSubscriber -Force | Unregister-Event -Force
A Force paraméter Get-EventSubscriber
használatával lekéri a munkamenet összes esemény-előfizető objektumát, beleértve a rejtett előfizetőket is. A kimenet a következőre Unregister-Event
van állítva, amely törli az előfizetőket a munkamenetből. A Rejtett előfizetők eltávolításához a Force paraméter szükséges Unregister-Event
.
Paraméterek
-Confirm
Jóváhagyást kér a parancsmag futtatása előtt.
Típus: | SwitchParameter |
Aliases: | cf |
Position: | Named |
alapértelmezett érték: | False |
Kötelező: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Force
Megszakítja az összes esemény-előfizetést, beleértve azokat az előfizetéseket is, amelyeket a SupportEvent paraméterrel Register-ObjectEvent
rejtettek el. Register-WmiEvent
Register-EngineEvent
Típus: | SwitchParameter |
Position: | Named |
alapértelmezett érték: | None |
Kötelező: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SourceIdentifier
Megadja a forrásazonosítót, amelyet ez a parancsmag megszakít az esemény-előfizetések számára.
Minden parancsban szerepelnie kell egy SourceIdentifier vagy SubscriptionId paraméternek.
Típus: | String |
Position: | 0 |
alapértelmezett érték: | None |
Kötelező: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-SubscriptionId
Megadja a forrásazonosító azonosítóját, amely a parancsmag megszakítja az esemény-előfizetéseket.
Minden parancsban szerepelnie kell egy SourceIdentifier vagy SubscriptionId paraméternek.
Típus: | Int32 |
Position: | 0 |
alapértelmezett érték: | None |
Kötelező: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WhatIf
Bemutatja, mi történne a parancsmag futtatásakor. A parancsmag nem fut.
Típus: | SwitchParameter |
Aliases: | wi |
Position: | Named |
alapértelmezett érték: | False |
Kötelező: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Bevitelek
A kimenetet a parancsmagba Get-EventSubscriber
is becsúszthatja.
Kimenetek
None
Ez a parancsmag nem ad vissza kimenetet.
Jegyzetek
Linux vagy macOS platformokon nem érhetők el eseményforrások.
Az események, az esemény-előfizetések és az eseménysor csak az aktuális munkamenetben léteznek. Ha bezárja az aktuális munkamenetet, a rendszer elveti az eseménysort, és megszakítja az esemény-előfizetést.
Unregister-Event
A parancsmag használatával New-Event
létrehozott események csak akkor törölhetők, ha a parancsmag használatával iratkozott fel az Register-EngineEvent
eseményre. Ha törölni szeretne egy egyéni eseményt a munkamenetből, akkor azt programozott módon el kell távolítania, vagy be kell zárnia a munkamenetet.