Remove-Event
Exclui eventos da fila de eventos.
Sintaxe
BySource (Predefinição)
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.
Este cmdlet exclui apenas os eventos atualmente na fila. Para cancelar registros de eventos ou cancelar a inscrição, use o cmdlet Unregister-Event.
Exemplos
Exemplo 1: Remover um evento por identificador de origem
PS C:\> Remove-Event -SourceIdentifier "ProcessStarted"
Este comando exclui eventos com um identificador de origem de Processo Iniciado da fila de eventos.
Exemplo 2: Remover um evento por identificador de evento
PS C:\> Remove-Event -EventIdentifier 30
Este 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
Este comando exclui todos os eventos da fila de eventos.
Parâmetros
-Confirm
Solicita confirmação antes de executar o cmdlet.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | False |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | Cf. |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-EventIdentifier
Especifica o identificador de evento que o cmdlet deve eliminar. Um parâmetro EventIdentifier ou SourceIdentifier é necessário em cada comando.
Propriedades dos parâmetros
| Tipo: | Int32 |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
ByIdentifier
| Position: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
-SourceIdentifier
Especifica o identificador de origem do qual esse cmdlet exclui eventos. Curingas não são permitidos. Um parâmetro EventIdentifier ou SourceIdentifier é necessário em cada comando.
Propriedades dos parâmetros
| Tipo: | String |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
BySource
| Position: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | False |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | Wi |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | 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
Este cmdlet não retorna nenhuma saída.
Notas
Não há fontes de eventos disponíveis nas plataformas Linux ou macOS.
Eventos, assinaturas de eventos e a fila de eventos existem somente na sessão atual. Se você fechar a sessão atual, a fila de eventos será descartada e a assinatura do evento será cancelada.
