Remove-Event

Elimina eventi dalla coda degli eventi.

Sintassi

Remove-Event [-EventIdentifier] <int> [-Confirm] [-WhatIf] [<CommonParameters>]

Remove-Event [-SourceIdentifier] <string> [-Confirm] [-WhatIf] [<CommonParameters>]

Descrizione

Il cmdlet Remove-Event elimina eventi dalla coda degli eventi nella sessione corrente.

Questo cmdlet elimina solo gli eventi attualmente presenti nella coda. Per annullare la registrazione di eventi o la sottoscrizione, utilizzare il cmdlet Unregister-Event.

Parametri

-EventIdentifier <int>

Elimina solo l'evento con l'identificatore evento specificato. Un parametro EventIdentifier o SourceIdentifier è obbligatorio in ogni comando.

Obbligatorio?	true
Posizione?	1
Valore predefinito	nessuno
Accettare input da pipeline?	true (ByPropertyName)
Accettare caratteri jolly?	false

-SourceIdentifier <string>

Elimina solo gli eventi con l'identificatore di origine specificato. Non è consentito l'utilizzo di caratteri jolly. Un parametro EventIdentifier o SourceIdentifier è obbligatorio in ogni comando.

Obbligatorio?	true
Posizione?	1
Valore predefinito	nessuno
Accettare input da pipeline?	false
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.PSEventArgs

È possibile reindirizzare eventi da Get-Event a Remove-Event.

Output

Nessuno

Il cmdlet non genera 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.

Esempio 1

C:\PS>remove-event -sourceIdentifier "ProcessStarted"

Descrizione
-----------
Questo comando elimina gli eventi con un identificatore di origine "Process Started" dalla coda degli eventi.

Esempio 2

C:\PS>remove-event -eventIdentifier 30

Descrizione
-----------
Questo comando elimina l'evento con un ID evento pari a 30 dalla coda degli eventi.

Esempio 3

C:\PS>get-event | remove-event

Descrizione
-----------
Questo comando elimina tutti gli eventi dalla coda degli eventi.