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.

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 viene eliminato il cmdlet. 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 gli effetti dell'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 tramite pipe gli eventi da Get-Event a questo cmdlet.

Output

None

Questo cmdlet non restituisce output.

Note

Nessuna origine evento disponibile nelle piattaforme Linux o macOS.

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.