Unregister-Event
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 evento creata usando il Register-EngineEvent
cmdlet , Register-ObjectEvent
o 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 evento in base all'identificatore di origine
PS C:\> Unregister-Event -SourceIdentifier "ProcessStarted"
Questo comando annulla la sottoscrizione dell'evento con un identificatore di origine di ProcessStarted.
Per trovare l'identificatore di origine di un evento, usare il Get-Event
cmdlet. Per trovare l'identificatore di origine di una sottoscrizione evento, usare il Get-EventSubscriber
cmdlet.
Esempio 2: Annullare una sottoscrizione evento in base all'identificatore della 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 evento, 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 cmdlet per ottenere tutti gli oggetti sottoscrittori eventi nella sessione, inclusi i sottoscrittori nascosti usando il Get-EventSubscriber
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à, è necessario anche il parametro Force in Unregister-Event
.
Parametri
-Confirm
Richiede la conferma dell'utente 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 degli eventi, incluse le sottoscrizioni nascoste usando il parametro SupportEvent di Register-ObjectEvent
, Register-WmiEvent
e 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 degli 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 degli 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 l'esito in caso di 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
È possibile inviare 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 usando il New-Event
cmdlet, a meno che non sia stato sottoscritto l'evento usando il Register-EngineEvent
cmdlet. Per eliminare un evento personalizzato dalla sessione, è necessario rimuoverlo a livello di codice o chiudere la sessione.