Remove-Event
Elimina eventos de la cola de eventos.
Sintaxis
BySource (Es el valor predeterminado).
Remove-Event
[-SourceIdentifier] <String>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ByIdentifier
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 de la cola de eventos los eventos con un identificador de origen "Process Started".
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.
Propiedades del parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | False |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | cf |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-EventIdentifier
Especifica el identificador de evento que el cmdlet elimina. Se requiere un parámetro EventIdentifier o SourceIdentifier en cada comando.
Propiedades del parámetro
| Tipo: | Int32 |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
ByIdentifier
| Posición: | 0 |
| Mandatory: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | True |
| Valor de los argumentos restantes: | 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 cada comando.
Propiedades del parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
BySource
| Posición: | 0 |
| Mandatory: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-WhatIf
Muestra lo que sucedería si el cmdlet se ejecuta. El cmdlet no se ejecuta.
Propiedades del parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | False |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | Wi |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
CommonParameters
Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.
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 se cierra la sesión actual, se descarta la fila de eventos y se cancela la suscripción al evento.
