Compartilhar via


Remove-Event

Exclui eventos da fila de eventos.

Sintaxe

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

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

Descrição

O cmdlet Remove-Event exclui eventos da fila de eventos da sessão atual.

Esse cmdlet só exclui os eventos atualmente na fila. Para cancelar registros de assinatura ou a assinatura, use o cmdlet Unregister-Event.

Parâmetros

-EventIdentifier <int>

Exclui somente o evento com o identificador de evento especificado. Um parâmetro EventIdentifier ou SourceIdentifier é necessário em cada comando.

Necessário?

true

Posição?

1

Valor padrão

Nenhum

Aceitar entrada do pipeline?

true (ByPropertyName)

Aceitar caracteres curinga?

false

-SourceIdentifier <string>

Exclui somente os eventos com o identificador de origem especificado. Os caracteres curinga não são permitidos. Um parâmetro EventIdentifier ou SourceIdentifier é necessário em cada comando.

Necessário?

true

Posição?

1

Valor padrão

Nenhum

Aceitar entrada do pipeline?

false

Aceitar caracteres curinga?

false

-Confirm

Solicita confirmação antes da execução do comando.

Necessário?

false

Posição?

named

Valor padrão

Aceitar entrada do pipeline?

false

Aceitar caracteres curinga?

false

-WhatIf

Descreve o que aconteceria se você executasse o comando, sem executá-lo de fato.

Necessário?

false

Posição?

named

Valor padrão

Aceitar entrada do pipeline?

false

Aceitar caracteres curinga?

false

<CommonParameters>

Esse cmdlet oferece suporte aos parâmetros comuns: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Para obter mais informações, consulte about_Commonparameters.

Entradas e saídas

O tipo de entrada é o tipo dos objetos que você pode canalizar para o cmdlet. O tipo de retorno é o tipo dos objetos que o cmdlet retorna.

Entradas

System.Management.Automation.PSEventArgs

É possível enviar eventos de Get-Event para Remove-Event.

Saídas

Nenhum

O cmdlet não gera saída.

Observações

Eventos, assinaturas de eventos e a fila de eventos só existem na sessão atual. Se você fechar a sessão atual, a fila de eventos será descartada e a assinatura de evento será cancelada.

Exemplo 1

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

Descrição
-----------
Este comando exclui eventos com o identificador de origem de "Process Started" da fila de eventos.





Exemplo 2

C:\PS>remove-event -eventIdentifier 30

Descrição
-----------
Este comando exclui o evento com ID de evento de 30 da fila de eventos.





Exemplo 3

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

Descrição
-----------
Este comando exclui todos os eventos da fila de eventos.





Consulte também

Conceitos

Register-ObjectEvent
Register-EngineEvent
Register-WmiEvent
Unregister-Event
Get-Event
New-Event
Remove-Event
Wait-Event