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

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

Questo comando annulla la sottoscrizione di eventi con un identificatore di origine 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

PS C:\> Unregister-Event -SubscriptionId 2

Questo comando annulla la sottoscrizione dell'evento con identificatore di sottoscrizione 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

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

Questo comando annulla tutte le sottoscrizioni di eventi della sessione.

Il comando usa il Get-EventSubscriber cmdlet per ottenere tutti gli oggetti sottoscrittori eventi nella sessione, inclusi i sottoscrittori nascosti usando il parametro SupportEvent dei cmdlet di registrazione eventi.

Usa un operatore pipeline (|) per inviare gli oggetti sottoscrittori a Unregister-Event, che li elimina dalla sessione. Per completare l'attività, il parametro Force è necessario anche in Unregister-Event.

Parametri

-Confirm

Richiede conferma prima di eseguire il cmdlet.

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

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

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

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

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required: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

Nessuna origine evento disponibile nelle piattaforme Linux o macOS.

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.