Поделиться через

Clear-EventLog

  • Ссылка
Модуль:
Microsoft.PowerShell.Management

Очищает все записи из указанных журналов событий на локальных или удаленных компьютерах.

Синтаксис

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

Описание

Командлет Clear-EventLog удаляет все записи из указанных журналов событий на локальном компьютере или на удаленных компьютерах. Чтобы использовать Clear-EventLog, необходимо быть членом группы "Администраторы" на затронутом компьютере.

Командлеты, содержащие существительное EventLog (командлеты EventLog), работают только в классических журналах событий. Чтобы получить события из журналов, использующих технологию журнала событий Windows в Windows Vista и более поздних версиях Windows, используйте командлет Get-WinEvent.

Примеры

Пример 1. Очистка определенных типов журналов событий с локального компьютера

Clear-EventLog "Windows PowerShell"

Эта команда очищает записи из журнала событий Windows PowerShell на локальном компьютере.

Пример 2. Очистка определенных типов журналов с локальных и удаленных компьютеров

Clear-EventLog -LogName ODiag, OSession -ComputerName localhost, Server02

Эта команда очищает все записи в журналах диагностики Microsoft Office (ODiag) и сеансов Microsoft Office (OSession) на локальном компьютере и удаленном компьютере Server02.

Пример 3. Очистка всех журналов на указанных компьютерах и отображение списка журналов событий

Clear-EventLog -LogName application, system -confirm

Эта команда запрашивает подтверждение перед удалением записей в указанных журналах событий.

Пример 4. Очистка всех журналов на указанных компьютерах и отображение списка журналов событий

function clear-all-event-logs ($computerName="localhost")
{
   $logs = Get-EventLog -ComputerName $computername -List | ForEach-Object {$_.Log}
   $logs | ForEach-Object {Clear-EventLog -ComputerName $computername -LogName $_ }
   Get-EventLog -ComputerName $computername -list
}

clear-all-event-logs -ComputerName Server01

Max(K) Retain OverflowAction        Entries Log
------ ------ --------------        ------- ---
15,168      0 OverwriteAsNeeded           0 Application
15,168      0 OverwriteAsNeeded           0 DFS Replication
512         7 OverwriteOlder              0 DxStudio
20,480      0 OverwriteAsNeeded           0 Hardware Events
512         7 OverwriteOlder              0 Internet Explorer
20,480      0 OverwriteAsNeeded           0 Key Management Service
16,384      0 OverwriteAsNeeded           0 Microsoft Office Diagnostics
16,384      0 OverwriteAsNeeded           0 Microsoft Office Sessions
30,016      0 OverwriteAsNeeded           1 Security
15,168      0 OverwriteAsNeeded           2 System
15,360      0 OverwriteAsNeeded           0 Windows PowerShell

Эта функция очищает все журналы событий на указанных компьютерах, а затем отображает результирующий список журналов событий.

Обратите внимание, что несколько записей были добавлены в журналы системы и безопасности после очистки журналов, но до их отображения.

Параметры

-ComputerName

Указывает удаленный компьютер. По умолчанию используется локальный компьютер.

Введите имя NetBIOS, IP-адрес или полное доменное имя удаленного компьютера. Чтобы указать локальный компьютер, введите имя компьютера, точку (.) или localhost.

Этот параметр не зависит от удаленного взаимодействия Windows PowerShell. Параметр Get-EventLog ComputerName можно использовать, даже если компьютер не настроен для выполнения удаленных команд.

Тип:String[]
Aliases:Cn
Position:1
Default value:Local computer
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-Confirm

Запрашивает подтверждение перед запуском командлета.

Тип:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-LogName

Указывает журналы событий. Введите имя журнала (значение свойства журнала не LogDisplayName) одного или нескольких журналов событий, разделенных запятыми. Подстановочные знаки не разрешены. Этот параметр является обязательным.

Важный

Этот параметр должен принимать значения из конвейера по имени свойства. Однако существует ошибка, которая не позволяет работать. Необходимо передать значение напрямую с помощью параметра.

Тип:String[]
Aliases:LN
Position:0
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-WhatIf

Показывает, что произойдет, если командлет выполняется. Командлет не выполняется.

Тип:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

Входные данные

None

Невозможно передать объекты в Clear-EventLog.

Выходные данные

None

Этот командлет не создает выходные данные.

Примечания

  • Чтобы использовать Clear-EventLog в Windows Vista и более поздних версиях Windows, запустите Windows PowerShell с параметром Запуск от имени администратора.