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