Remove-Event

Elimina eventos de la cola de eventos.

Sintaxis

Remove-Event [-EventIdentifier] <int> [-Confirm] [-WhatIf] [<CommonParameters>]

Remove-Event [-SourceIdentifier] <string> [-Confirm] [-WhatIf] [<CommonParameters>]

Descripción

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

Este cmdlet elimina únicamente los eventos que están actualmente en la cola. Para cancelar los registros de eventos o la suscripción, utilice el cmdlet Unregister-Event.

Parámetros

-EventIdentifier <int>

Elimina solo el evento con el identificador de evento especificado. Cada comando requiere un parámetro EventIdentifier o SourceIdentifier.

¿Requerido?	true
¿Posición?	1
Valor predeterminado	ninguno
¿Aceptar canalización?	true (ByPropertyName)
¿Aceptar caracteres comodín?	false

-SourceIdentifier <string>

Elimina solo los eventos con el identificador de origen especificado. No se permite el uso de caracteres comodín. Cada comando requiere un parámetro EventIdentifier o SourceIdentifier.

¿Requerido?	true
¿Posición?	1
Valor predeterminado	ninguno
¿Aceptar canalización?	false
¿Aceptar caracteres comodín?	false

-Confirm

Solicita confirmación antes de ejecutar el comando.

¿Requerido?	false
¿Posición?	named
Valor predeterminado
¿Aceptar canalización?	false
¿Aceptar caracteres comodín?	false

-WhatIf

Describe lo que ocurriría si ejecutara el comando sin ejecutarlo realmente.

¿Requerido?	false
¿Posición?	named
Valor predeterminado
¿Aceptar canalización?	false
¿Aceptar caracteres comodín?	false

<CommonParameters>

Este cmdlet admite los parámetros comunes: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer y -OutVariable. Para obtener más información, vea about_Commonparameters.

Entradas y salidas

El tipo de entrada es el tipo de los objetos que se pueden canalizar al cmdlet. El tipo devuelto es el tipo de los objetos que el cmdlet devuelve.

Entradas

System.Management.Automation.PSEventArgs

Se pueden canalizar eventos desde Get-Event hasta Remove-Event.

Salidas

Ninguno

El cmdlet no genera resultados.

Notas

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 descartará la cola de eventos y se cancelará la suscripción de eventos.

Ejemplo 1

C:\PS>remove-event -sourceIdentifier "ProcessStarted"

Descripción
-----------
Este comando elimina de la cola de eventos los eventos con el identificador de origen "Process Started".

Ejemplo 2

C:\PS>remove-event -eventIdentifier 30

Descripción
-----------
Este comando elimina de la cola de eventos el evento con el identificador 30.

Ejemplo 3

C:\PS>get-event | remove-event

Descripción
-----------
Este comando elimina todos los eventos de la cola de eventos.