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 cmdlet Remove-Event elimina gli eventi dalla coda di eventi nella sessione corrente.

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

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 di 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 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

-EventIdentifier

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

Type:Int32
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
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

PSEventArgs

È possibile inviare eventi di pipe da Get-Event a Remove-Event.

Output

None

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