Remove-Event
Exclui eventos da fila de eventos.
Sintaxe
BySource (Default)
Remove-Event
[-SourceIdentifier] <String>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ByIdentifier
Remove-Event
[-EventIdentifier] <Int32>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
O cmdlet Remove-Event exclui eventos da fila de eventos na sessão atual.
Esse cmdlet exclui apenas os eventos atualmente na fila. Para cancelar registros de eventos ou cancelar a assinatura, use o cmdlet Unregister-Event.
Exemplos
Exemplo 1: remover um evento por identificador de origem
PS C:\> Remove-Event -SourceIdentifier "ProcessStarted"
Esse comando exclui eventos com um identificador de origem do Processo Iniciado da fila de eventos.
Exemplo 2: remover um evento por identificador de evento
PS C:\> Remove-Event -EventIdentifier 30
Esse comando exclui o evento com uma ID de evento de 30 da fila de eventos.
Exemplo 3: remover todos os eventos
PS C:\> Get-Event | Remove-Event
Esse comando exclui todos os eventos da fila de eventos.
Parâmetros
-Confirm
Solicita sua confirmação antes de executar o cmdlet.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | False |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | cf |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-EventIdentifier
Especifica o identificador de evento para o qual o cmdlet exclui. Um parâmetro EventIdentifier ou SourceIdentifier é necessário em todos os comandos.
Propriedades do parâmetro
| Tipo: | Int32 |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
ByIdentifier
| Cargo: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-SourceIdentifier
Especifica o identificador de origem do qual esse cmdlet exclui eventos. Caracteres curinga não são permitidos. Um parâmetro EventIdentifier ou SourceIdentifier é necessário em todos os comandos.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
BySource
| Cargo: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | False |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | wi |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.
Entradas
PSEventArgs
Você pode canalizar eventos de Get-Event para este cmdlet.
Saídas
None
Esse cmdlet não retorna nenhuma saída.
Observações
Nenhuma fonte de evento disponível nas plataformas Linux ou macOS.
Eventos, assinaturas de evento e a fila de eventos existem apenas na sessão atual. Se você fechar a sessão atual, a fila de eventos será descartada e a assinatura do evento será cancelada.