Compartir a través de

Remove-Event

  • Referencia
Módulo:
Microsoft.PowerShell.Utility

Elimina eventos de la cola de eventos.

Sintaxis

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

Description

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

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

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 el evento con un identificador de evento de 30 de la cola de eventos.

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 pide confirmación antes de ejecutar el cmdlet.

Tipo:SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-EventIdentifier

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

Tipo:Int32
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-SourceIdentifier

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

Tipo:String
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-WhatIf

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

Tipo:SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

PSEventArgs

Puede canalizar eventos de Get-Event a este cmdlet.

Salidas

None

Este cmdlet no devuelve ninguna salida.

Notas

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

Los eventos, las suscripciones de eventos y la cola de eventos solo existen en la sesión actual. Si cierra la sesión actual, se descarta la cola de eventos y se cancela la suscripción de eventos.