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

None

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.