Remove-Event

  • Referencia
Módulo:
Microsoft.PowerShell.Utility

Elimina eventos de la cola de eventos.

Syntax

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

Description

El Remove-Event cmdlet elimina los eventos de la cola de eventos en la sesión actual.

Este cmdlet elimina solo los eventos actualmente en la cola. Para cancelar los registros de eventos o cancelar la suscripción, use el Unregister-Event cmdlet .

Ejemplos

Ejemplo 1: Eliminación de un evento por identificador de origen

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

Este comando elimina eventos con un identificador de origen del proceso iniciado desde la cola de eventos.

Ejemplo 2: Eliminación de un evento por identificador de evento

PS C:\> Remove-Event -EventIdentifier 30

Este comando elimina de la cola de eventos el evento con un identificador de evento de 30.

Ejemplo 3: Quitar todos los eventos

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

Este comando elimina todos los eventos de la cola de eventos.

Parámetros

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EventIdentifier

Especifica el identificador de evento para el que se elimina el cmdlet. Se requiere un parámetro EventIdentifier o SourceIdentifier en todos los comandos.

Type:Int32
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-SourceIdentifier

Especifica el identificador de origen del que este cmdlet elimina los eventos. No se permiten caracteres comodín. Se requiere un parámetro EventIdentifier o SourceIdentifier en todos los comandos.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

PSEventArgs

Puede canalizar eventos de Get-Event a este cmdlet.

Salidas

None

Este cmdlet no devuelve ningún resultado.

Notas

No hay orígenes de eventos disponibles en las plataformas Linux o macOS.

La cola de eventos, las suscripciones de eventos y los eventos solo existen en la sesión actual. Si la cierra, la cola de eventos se descartará y la suscripción al evento se cancelará.