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

Синтаксис

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

Описание

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

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

Параметры

-ComputerName <string[]>

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

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

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

Обязательно?

false

Позиция?

2

Значение по умолчанию

Local computer

Принимать входные данные из конвейера?

true (ByPropertyName)

Принимать подстановочные знаки?

false

-LogName <string[]>

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

Обязательно?

true

Позиция?

1

Значение по умолчанию

Принимать входные данные из конвейера?

true (ByPropertyName)

Принимать подстановочные знаки?

false

-Confirm

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

Обязательно?

false

Позиция?

named

Значение по умолчанию

Принимать входные данные из конвейера?

false

Принимать подстановочные знаки?

false

-WhatIf

Описывает, что произойдет при выполнении команды, без ее фактического выполнения.

Обязательно?

false

Позиция?

named

Значение по умолчанию

Принимать входные данные из конвейера?

false

Принимать подстановочные знаки?

false

<CommonParameters>

Данный командлет поддерживает общие параметры -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer и -OutVariable. Дополнительные сведения см. в разделе about_Commonparameters.

Ввод и вывод

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

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

Нет

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

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

Нет

Этот командлет не формирует никаких выходных данных.

Примечания

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

Пример 1

C:\PS>clear-eventlog "Windows PowerShell"

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






Пример 2

C:\PS>clear-eventlog -logname ODiag, OSession -computername localhost, Server02

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






Пример 3

C:\PS>clear-eventlog -log application, system -confirm

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






Пример 4

C:\PS>function clear-all-event-logs ($computerName="localhost")
{
	$logs = get-eventlog -computername $computername -list | foreach {$_.Log} 
	$logs | foreach {clear-eventlog -comp $computername -log $_ }
	get-eventlog -computername $computername -list
}

C:\PS> clear-all-event-logs -comp 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

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

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






См. также