Записывает событие в журнал событий.

Синтаксис

Write-EventLog [-LogName] <string> [-Source] <string> [-EventID] <int> [-Message] <string> [[-EntryType] {<Error> | <Warning> | <Information> | <SuccessAudit> | <FailureAudit>}] [-Category <Int16>] [-ComputerName <string>] [-RawData <Byte[]>] [<CommonParameters>]

Описание

Командлет записывает Write-EventLog событие в журнал событий.

Чтобы событие можно было записать в журнал событий, журнал событий должен существовать на компьютере, и для этого журнала событий должен быть зарегистрирован источник.

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

Параметры

-Category <Int16>

Задает категорию задачи для события. Введите целочисленное значение, связанное со строками в файле сообщений категорий для журнала событий.

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

false

Позиция?

named

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

1

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

false

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

false

-ComputerName <string>

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

Введите имя NetBIOS, IP-адрес или полное доменное имя удаленного компьютера.

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

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

false

Позиция?

named

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

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

false

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

false

-EntryType <EventLogEntryType>

Задает тип записи события. Допустимые значения: Error, Warning, Information, SuccessAudit и FailureAudit. По умолчанию используется значение "Information".

Описание значений см. в разделе System.Diagnostics.EventLogEntryType в библиотеке MSDN (Microsoft Developer Network) по адресу https://go.microsoft.com/fwlink/?LinkId=143599.

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

false

Позиция?

4

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

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

false

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

false

-EventID <int>

Задает идентификатор события. Это обязательный параметр.

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

true

Позиция?

3

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

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

false

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

false

-LogName <string>

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

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

true

Позиция?

1

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

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

false

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

false

-Message <string>

Задает сообщение о событии. Это обязательный параметр.

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

true

Позиция?

5

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

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

false

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

false

-RawData <Byte[]>

Задает двоичные данные, связанные с событием, в байтах.

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

false

Позиция?

named

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

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

false

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

false

-Source <string>

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

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

true

Позиция?

2

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

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

false

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

false

<CommonParameters>

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

Ввод и вывод

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

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

Нет

Передать входные данные этому командлету по конвейеру невозможно.

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

System.Diagnostics.EventLogEntry

Командлет Write-EventLog возвращает объекты, представляющие события в журналах.

Примечания

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

Пример 1

C:\PS>write-eventlog -logname Application -source MyApp -eventID 3001 -entrytype Information -message "MyApp added a user-requested feature to the display." -category 1 -rawdata 10,20

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






Пример 2

C:\PS>write-eventlog -computername Server01 -logname Application -source MyApp -eventID 3001 -message "MyApp added a user-requested feature to the display."

Описание
-----------
Эта команда записывает событие из источника MyApp в журнал событий Application на удаленном компьютере Server01.






См. также




Содержание