Unregister-Event
Megszakít egy esemény-előfizetést.
Syntax
BySource (Alapértelmezett)
Unregister-Event
[-SourceIdentifier] <String>
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ById
Unregister-Event
[-SubscriptionId] <Int32>
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
A Unregister-Event parancsmag megszakítja a Register-EngineEvent, Register-ObjectEventvagy Register-WmiEvent parancsmaggal 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. Ha lemond egy előfizetést egy eseményre, amelyet a New-Event parancsmaggal hoz létre, az új esemény is törlődik a munkamenetből.
Unregister-Event nem törli az eseményeket az eseménysorból. 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. Egy 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éterrel Get-EventSubscriber lekéri a munkamenet összes esemény-előfizető objektumát, beleértve a rejtett előfizetőket is. A kimenet a Unregister-Eventlesz, amely törli az előfizetőket a munkamenetből. A rejtett előfizetők eltávolításához a Unregister-Event paraméter szükséges.
Paraméterek
-Confirm
Megerősítést kér a parancsmag futtatása előtt.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | False |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | Cf |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Force
Megszakítja az összes esemény-előfizetést, beleértve a SupportEvent paraméterrel elrejtett előfizetéseket is, Register-ObjectEvent, Register-WmiEventés Register-EngineEvent.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | 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.
Paramétertulajdonságok
| Típus: | String |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
BySource
| Position: | 0 |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | True |
| Fennmaradó argumentumokból származó érték: | 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.
Paramétertulajdonságok
| Típus: | Int32 |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
ById
| Position: | 0 |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | True |
| Fennmaradó argumentumokból származó érték: | False |
-WhatIf
Megjeleníti, mi történne, ha a parancsmag futna. A parancsmag nem fut.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | False |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | Wi |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
CommonParameters
Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.
Bevitelek
PSEventSubscriber
A kimenetet a Get-EventSubscriber a parancsmagba csövezheti.
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 nem törölheti az New-Event parancsmaggal létrehozott eseményeket, hacsak nem iratkozott fel az eseményre a Register-EngineEvent parancsmag használatával. 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.
