Annulla la sottoscrizione di un evento.
Sintassi
Unregister-Event [-SubscriptionId] <int> [-Force] [-Confirm] [-WhatIf] [<CommonParameters>] Unregister-Event [-SourceIdentifier] <string> [-Force] [-Confirm] [-WhatIf] [<CommonParameters>]
Descrizione
Il cmdlet Unregister-Event annulla la sottoscrizione di un evento creata tramite i cmdlet Register-EngineEvent, Register-ObjectEvent o Register-WmiEvent.
Quando la sottoscrizione di un evento viene annullata, il sottoscrittore di eventi verrà eliminato dalla sessione e gli eventi sottoscritti non saranno più aggiunti alla coda degli eventi. Quando si annulla una sottoscrizione di un evento creata tramite il cmdlet New-Event, anche il nuovo evento verrà eliminato dalla sessione.
Unregister-Event non elimina eventi dalla coda degli eventi. Per eliminare gli eventi, utilizzare il cmdlet Remove-Event.
Parametri
-Force
Annulla tutte le sottoscrizioni di eventi, incluse le sottoscrizioni nascoste mediante il parametro SupportEvent di Register-ObjectEvent, Register-WmiEvent e Register-EngineEvent.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
-SourceIdentifier <string>
Annulla le sottoscrizioni di eventi che dispongono dell'identificatore di origine specificato.
È necessario che sia incluso un parametro SourceIdentifier o SubscriptionId in ogni comando.
|
Obbligatorio? |
true |
|
Posizione? |
1 |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
true (ByPropertyName) |
|
Accettare caratteri jolly? |
false |
-SubscriptionId <int>
Annulla le sottoscrizioni di eventi che dispongono dell'identificatore di sottoscrizione specificato.
È necessario che sia incluso un parametro SourceIdentifier o SubscriptionId in ogni comando.
|
Obbligatorio? |
true |
|
Posizione? |
1 |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
true (ByPropertyName) |
|
Accettare caratteri jolly? |
false |
-Confirm
Chiede una conferma prima di eseguire il comando.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
-WhatIf
Descrive ciò che accadrebbe se si eseguisse il comando senza eseguirlo realmente.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
<CommonParameters>
Questo cmdlet supporta i parametri comuni -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Per ulteriori informazioni, vedere about_Commonparameters.
Input e output
Il tipo di input è il tipo degli oggetti che è possibile reindirizzare al cmdlet. Il tipo restituito è il tipo degli oggetti restituiti dal cmdlet.
|
Input |
System.Management.Automation.PSEventSubscriber È possibile reindirizzare l'output da Get-EventSubscriber a Unregister-Event. |
|
Output |
Nessuno Questo cmdlet non restituisce alcun 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 eliminata e la sottoscrizione di eventi viene annullata.
Unregister-Event non può eliminare eventi creati tramite il cmdlet New-Event a meno che l'evento non sia stato sottoscritto tramite il cmdlet Register-EngineEvent. Per eliminare un evento personalizzato dalla sessione, è necessario rimuoverlo a livello di codice o chiudere la sessione.
Esempio 1
C:\PS>unregister-event -sourceIdentifier ProcessStarted Descrizione ----------- Questo comando annulla la sottoscrizione dell'evento che dispone di un identificatore di origine "ProcessStarted". Per trovare l'identificatore di origine di un evento, utilizzare il cmdlet Get-Event. Per trovare l'identificatore di origine della sottoscrizione di un evento, utilizzare il cmdlet Get-EventSubscriber.
Esempio 2
C:\PS>unregister-event -subscriptionId 2 Descrizione ----------- Questo comando annulla la sottoscrizione dell'evento che dispone di un identificatore di sottoscrizione di 2. Per trovare l'identificatore di sottoscrizione della sottoscrizione di un evento, utilizzare il cmdlet Get-EventSubscriber.
Esempio 3
C:\PS>get-eventsubscriber -force | unregister-event -force Descrizione ----------- 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 tramite il parametro SupportEvent dei cmdlet di registrazione eventi. Viene utilizzato un operatore pipeline (|) per inviare gli oggetti sottoscrittore a Unregister-Event che li elimina dalla sessione. Per completare l'attività, è inoltre richiesto il parametro Force in Unregister-Event.
Vedere anche