Unregister-Event
Annulla una sottoscrizione di eventi.
Sintassi
BySource (Impostazione predefinita)
Unregister-Event
[-SourceIdentifier] <String>
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ById
Unregister-Event
[-SubscriptionId] <Int32>
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Descrizione
Il cmdlet Unregister-Event annulla una sottoscrizione di eventi creata utilizzando il cmdlet Register-EngineEvent, Register-ObjectEvent o Register-WmiEvent.
Quando una sottoscrizione di eventi viene annullata, il sottoscrittore di eventi viene eliminato dalla sessione e gli eventi sottoscritti non vengono più aggiunti alla coda di eventi. Quando si annulla una sottoscrizione a un evento creato utilizzando il cmdlet New-Event, anche il nuovo evento viene eliminato dalla sessione.
Unregister-Event non elimina gli eventi dalla coda degli eventi. Per eliminare gli eventi, utilizzare il cmdlet Remove-Event.
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 identificatore di origine "ProcessStarted".
Per trovare l'identificatore di origine di un evento, utilizzare il cmdlet Get-Event. Per trovare l'identificatore di origine di una sottoscrizione di eventi, utilizzare il cmdlet Get-EventSubscriber .
Esempio 2: Annullare una sottoscrizione di eventi in base all'identificatore di sottoscrizione
PS C:\> Unregister-Event -SubscriptionId 2
Questo comando annulla la sottoscrizione di eventi con un identificatore di sottoscrizione pari a 2.
Per trovare l'identificatore di sottoscrizione di una sottoscrizione di eventi, utilizzare il cmdlet Get-EventSubscriber .
Esempio 3: Annullare tutte le sottoscrizioni di eventi
PS C:\> Get-EventSubscriber -Force | Unregister-Event -Force
Questo comando annulla tutte le sottoscrizioni di eventi nella sessione.
Il comando utilizza il cmdlet Get-EventSubscriber per ottenere tutti gli oggetti sottoscrittore di eventi nella sessione, inclusi i sottoscrittori nascosti utilizzando il parametro SupportEvent dei cmdlet di registrazione degli eventi.
Utilizza un operatore pipeline (|) per inviare gli oggetti sottoscrittore a Unregister-Event, che li elimina dalla sessione. Per completare l'attività, il parametro Force è necessario anche su Unregister-Event.
Parametri
-Confirm
Richiede conferma prima di eseguire il cmdlet.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | False |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | cfr |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Force
Annulla tutte le sottoscrizioni di eventi, incluse le sottoscrizioni nascoste utilizzando il parametro SupportEvent di Register-ObjectEvent, Register-WmiEvent e Register-EngineEvent.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-SourceIdentifier
Specifica un identificatore di origine per le sottoscrizioni di eventi che questo cmdlet annulla.
In ogni comando deve essere incluso un parametro SourceIdentifier o un parametro SubscriptionId.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
BySource
| Posizione: | 0 |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
-SubscriptionId
Specifica un ID di identificatore di origine per annullare le sottoscrizioni di eventi associate a questo cmdlet.
In ogni comando deve essere incluso un parametro SourceIdentifier o un parametro SubscriptionId.
Proprietà dei parametri
| Tipo: | Int32 |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
ById
| Posizione: | 0 |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
-WhatIf
Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | False |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | Wi |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
CommonParameters
Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.
Input
PSEventSubscriber
È possibile reindirizzare l'output da Get-EventSubscriber a Unregister-Event.
Output
None
Questo cmdlet non restituisce alcun output.
Note
Gli eventi, le sottoscrizioni di eventi e la coda di eventi esistono solo nella sessione corrente. Se si chiude la sessione corrente, la coda di eventi viene eliminata e la sottoscrizione di eventi viene annullata.
Unregister-Event non è in grado di eliminare gli eventi creati utilizzando il cmdlet New-Event a meno che non sia stata effettuata la sottoscrizione all'evento utilizzando il cmdlet Register-EngineEvent . Per eliminare un evento personalizzato dalla sessione, è necessario rimuoverlo a livello di codice o chiudere la sessione.