Remove-EventLog

Sintaxe

Remove-EventLog
      [[-ComputerName] <String[]>]
      [-LogName] <String[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-EventLog
      [[-ComputerName] <String[]>]
      [-Source <String[]>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

O cmdlet Remove-EventLog exclui um arquivo de log de eventos de um computador local ou remoto e cancela o registro de todas as suas fontes de eventos para o log. Você também pode usar esse cmdlet para cancelar o registro de fontes de eventos sem excluir nenhum log de eventos.

Os cmdlets que contêm o substantivo eventLog , os cmdlets eventLog , funcionam somente em logs de eventos clássicos. Para obter eventos de logs que usam a tecnologia log de eventos do Windows no Windows Vista e versões posteriores do sistema operacional Windows, use Get-WinEvent.

CUIDADO: esse cmdlet pode excluir logs de eventos do sistema operacional, o que pode causar falhas de aplicativo e comportamento inesperado do sistema.

Exemplos

Exemplo 1: remover um log de eventos do computador local

PS C:\> Remove-EventLog -LogName "MyLog"

Esse comando exclui o log de eventos MyLog do computador local e cancela o registro de suas fontes de eventos.

Exemplo 2: remover um log de eventos de vários computadores

PS C:\> Remove-EventLog -LogName "MyLog", "TestLog" -ComputerName "Server01", "Server02", "localhost"

Esse comando exclui os logs de eventos MyLog e TestLog do computador local e dos computadores remotos Server01 e Server02. O comando também cancela o registro das fontes de evento para esses logs.

Exemplo 3: excluir uma fonte de evento

PS C:\> Remove-EventLog -Source "MyApp"

Esse comando exclui a origem do evento MyApp dos logs no computador local. Quando o comando é concluído, o programa MyApp não pode gravar em nenhum log de eventos.

Exemplo 4: remover um log de eventos e confirmar a ação

The first command lists the event logs on the local computer.
PS C:\> Get-EventLog -List
Max(K) Retain OverflowAction        Entries Log
------ ------ --------------        ------- ---
15,168      0 OverwriteAsNeeded      22,923 Application
15,168      0 OverwriteAsNeeded          53 DFS Replication
15,168      7 OverwriteOlder              0 Hardware Events
512      7 OverwriteOlder              0 Internet Explorer
20,480      0 OverwriteAsNeeded           0 Key Management Service
30,016      0 OverwriteAsNeeded      50,060 Security
15,168      0 OverwriteAsNeeded      27,592 System
15,360      0 OverwriteAsNeeded      18,355 Windows PowerShell
15,168      7 OverwriteAsNeeded          12 ZapLog

The second command deletes the ZapLog event log.
PS C:\> Remove-EventLog -LogName "ZapLog"

The third command lists the event logs again. The ZapLog event log no longer appears in the list.
PS C:\> Get-EventLog -List
Max(K) Retain OverflowAction        Entries Log
------ ------ --------------        ------- ---
15,168      0 OverwriteAsNeeded      22,923 Application
15,168      0 OverwriteAsNeeded          53 DFS Replication
15,168      7 OverwriteOlder              0 Hardware Events
512      7 OverwriteOlder              0 Internet Explorer
20,480      0 OverwriteAsNeeded           0 Key Management Service
30,016      0 OverwriteAsNeeded      50,060 Security
15,168      0 OverwriteAsNeeded      27,592 System
15,360      0 OverwriteAsNeeded      18,355 Windows PowerShell

Esses comandos mostram como listar os logs de eventos em um computador e verificar se um comando Remove-EventLog foi bem-sucedido.

Exemplo 5: remover uma origem do evento e confirmar a ação

PS C:\> Get-WmiObject win32_nteventlogfile -Filter "logfilename='TestLog'" | foreach {$_.sources}
MyApp
TestApp
PS C:\> Remove-Eventlog -Source "MyApp"
PS C:\> Get-WmiObject win32_nteventlogfile -Filter "logfilename='TestLog'"} | foreach {$_.sources}
TestApp

Esses comandos usam o cmdlet Get-WmiObject para listar as fontes de eventos no computador local. Você pode esses comandos para verificar o êxito de um comando ou excluir uma fonte de evento.

O primeiro comando obtém as fontes de evento do log de eventos TestLog no computador local. MyApp é uma das fontes.

O segundo comando usa o parâmetro origem de Remove-EventLog para excluir a origem do evento MyApp.

O terceiro comando é idêntico ao primeiro. Ele mostra que a origem do evento MyApp foi excluída.

Parâmetros

-ComputerName

-Confirm

-LogName

-Source

-WhatIf

Entradas

None

Não é possível redirecionar a entrada para este cmdlet.

Saídas

None

Esse cmdlet não retorna nenhuma saída.

Observações

• Para usar Remove-EventLog no Windows Vista e versões posteriores do sistema operacional Windows, inicie o Windows PowerShell usando a opção Executar como administrador.

  Se você remover um log de eventos e recriar o log, não poderá registrar as mesmas fontes de evento. Os aplicativos que usaram as fontes de eventos para gravar entradas no log original não poderão gravar no novo log.

• Quando você cancela o registro de uma fonte de evento para um log específico, a origem do evento pode ser impedida de gravar entradas em outros logs de eventos.

Links Relacionados

• Clear-EventLog
• Get-EventLog
• Limit-EventLog
• New-EventLog
• Remove-EventLog
• Show-EventLog
• Write-EventLog