Remove-Event
Exclui eventos da fila de eventos.
Syntax
Remove-Event
[-SourceIdentifier] <String>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-Event
[-EventIdentifier] <Int32>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
O Remove-Event
cmdlet exclui eventos da fila de eventos na sessão atual.
Este cmdlet exclui somente os eventos atualmente na fila. Para cancelar registros de eventos ou cancelar a assinatura, use o Unregister-Event
cmdlet .
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 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.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | Int32 |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | 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.
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
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 inscrição do evento será cancelada.