Condividi tramite

Unregister-Event

  • Riferimento
Modulo:
Microsoft.PowerShell.Utility

Annulla la sottoscrizione di un evento.

Sintassi

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

Descrizione

Il Unregister-Event cmdlet annulla una sottoscrizione di eventi creata usando il Register-EngineEventcmdlet , Register-ObjectEvento Register-WmiEvent .

Quando la sottoscrizione di un evento viene annullata, il sottoscrittore di eventi viene eliminato dalla sessione e gli eventi sottoscritti non vengono più aggiunti alla coda degli eventi. Quando si annulla una sottoscrizione a un evento creato usando il New-Event cmdlet , il nuovo evento viene eliminato anche dalla sessione.

Unregister-Event non elimina gli eventi dalla coda di eventi. Per eliminare gli eventi, usare il Remove-Event cmdlet .

Esempio

Esempio 1: Annullare una sottoscrizione di eventi in base all'identificatore di origine

Questo comando annulla la sottoscrizione di eventi con un identificatore di origine ProcessStarted.

Unregister-Event -SourceIdentifier "ProcessStarted"

Per trovare l'identificatore di origine di un evento, usare il Get-Event cmdlet . Per trovare l'identificatore di origine di una sottoscrizione di eventi, usare il Get-EventSubscriber cmdlet

Esempio 2: Annullare una sottoscrizione di eventi in base all'identificatore di sottoscrizione

Questo comando annulla la sottoscrizione dell'evento con identificatore di sottoscrizione 2.

Unregister-Event -SubscriptionId 2

Per trovare l'identificatore della sottoscrizione di una sottoscrizione di eventi, usare il Get-EventSubscriber cmdlet .

Esempio 3: Annullare tutte le sottoscrizioni di eventi

In questo esempio vengono annullate tutte le sottoscrizioni di eventi nella sessione.

Get-EventSubscriber -Force | Unregister-Event -Force

Usando il parametro Force con Get-EventSubscriber ottiene tutti gli oggetti sottoscrittori eventi nella sessione, inclusi i sottoscrittori nascosti. L'output viene inviato tramite pipe a Unregister-Event, che elimina i sottoscrittori dalla sessione. Il parametro Force è obbligatorio per Unregister-Event rimuovere tutti i sottoscrittori nascosti.

Parametri

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Aliases:cf
Position:Named
valore predefinito:False
Necessario:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

Annulla tutte le sottoscrizioni di eventi, incluse le sottoscrizioni nascoste usando il parametro SupportEvent di Register-ObjectEvent, Register-WmiEvente Register-EngineEvent.

Tipo:SwitchParameter
Position:Named
valore predefinito:None
Necessario:False
Accept pipeline input:False
Accept wildcard characters:False

-SourceIdentifier

Specifica un identificatore di origine che questo cmdlet annulla le sottoscrizioni di eventi.

Un parametro SourceIdentifier o SubscriptionId deve essere incluso in ogni comando.

Tipo:String
Position:0
valore predefinito:None
Necessario:True
Accept pipeline input:True
Accept wildcard characters:False

-SubscriptionId

Specifica un ID identificatore di origine che questo cmdlet annulla le sottoscrizioni di eventi.

Un parametro SourceIdentifier o SubscriptionId deve essere incluso in ogni comando.

Tipo:Int32
Position:0
valore predefinito:None
Necessario:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.

Tipo:SwitchParameter
Aliases:wi
Position:Named
valore predefinito:False
Necessario:False
Accept pipeline input:False
Accept wildcard characters:False

Input

PSEventSubscriber

È possibile inviare tramite pipe l'output da Get-EventSubscriber a questo cmdlet.

Output

None

Questo cmdlet non restituisce output.

Note

Gli eventi, le sottoscrizioni di eventi e la coda degli eventi esistono solo nella sessione corrente. Se si chiude la sessione corrente, la coda degli eventi viene rimossa e la sottoscrizione dell'evento viene annullata.

Unregister-Event non può eliminare gli eventi creati tramite il New-Event cmdlet a meno che non sia stata effettuata la sottoscrizione all'evento tramite il Register-EngineEvent cmdlet . Per eliminare un evento personalizzato dalla sessione, è necessario rimuoverlo a livello di codice o chiudere la sessione.