Unregister-Event

  • Referencia
Modul:
Microsoft.PowerShell.Utility

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-ObjectEventvagy Register-WmiEvent parancsmag használatával Register-EngineEventlé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

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

Ez a parancs megszakítja a ProcessStarted forrásazonosítójával rendelkező esemény-előfizetést.

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

PS C:\> Unregister-Event -SubscriptionId 2

Ez a parancs megszakítja a 2 előfizetési azonosítóval rendelkező esemény-előfizetést.

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

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

Ez a parancs megszakítja a munkamenet összes esemény-előfizetését.

A parancs a Get-EventSubscriber parancsmaggal lekéri a munkamenet összes esemény-előfizető objektumát, beleértve az eseményregisztrációs parancsmagok SupportEvent paraméterével elrejtett előfizetőket is.

Egy folyamatkezelőt (|) használ az előfizetői Unregister-Eventobjektumok elküldéséhez, amely törli őket a munkamenetből. A feladat elvégzéséhez a Force paraméterre is szükség van a következőn Unregister-Event: .

Paraméterek

-Confirm

Jóváhagyást kér a parancsmag futtatása előtt.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required: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-ObjectEventrejtettek el. Register-WmiEventRegister-EngineEvent

Type:SwitchParameter
Position:Named
Default value:None
Required: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.

Type:String
Position:0
Default value:None
Required: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.

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

-WhatIf

Bemutatja, mi történne a parancsmag futtatásakor. A parancsmag nem fut.

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

Bevitelek

PSEventSubscriber

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.