Condividi tramite

Remove-Event

  • Riferimento
Modulo:
Microsoft.PowerShell.Utility

Elimina eventi dalla coda degli eventi.

Sintassi

Remove-Event
      [-SourceIdentifier] <String>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-Event
      [-EventIdentifier] <Int32>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Descrizione

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

Questo cmdlet elimina solo gli eventi attualmente nella coda. Per annullare le registrazioni degli eventi o annullare la sottoscrizione, usare il Unregister-Event cmdlet .

Esempio

Esempio 1: Rimuovere un evento in base all'identificatore di origine

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

Questo comando elimina gli eventi con un identificatore di origine Process Started dalla coda di eventi.

Esempio 2: Rimuovere un evento in base all'identificatore di evento

PS C:\> Remove-Event -EventIdentifier 30

Questo comando elimina l'evento con l'ID evento 30 dalla coda degli eventi.

Esempio 3: Rimuovere tutti gli eventi

PS C:\> Get-Event | Remove-Event

Questo comando elimina tutti gli eventi dalla coda degli eventi.

Parametri

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-EventIdentifier

Specifica l'identificatore dell'evento per il quale viene eliminato il cmdlet. In ogni comando è necessario un parametro EventIdentifier o SourceIdentifier .

Tipo:Int32
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-SourceIdentifier

Specifica l'identificatore di origine da cui questo cmdlet elimina gli eventi. I caratteri jolly non sono consentiti. In ogni comando è necessario un parametro EventIdentifier o SourceIdentifier .

Tipo:String
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-WhatIf

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

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

PSEventArgs

È possibile inviare tramite pipe gli eventi da Get-Event a questo cmdlet.

Output

None

Questo cmdlet non restituisce 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 rimossa e la sottoscrizione dell'evento viene annullata.