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

Синтаксис

New-EventLog [-LogName] <string> [-Source] <string[]> [[-ComputerName] <string[]>] [-CategoryResourceFile <string>] [-MessageResourceFile <string>] [-ParameterResourceFile <string>] [<CommonParameters>]

Описание

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

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

Параметры

-CategoryResourceFile <string>

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

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

Обязательно?	false
Позиция?	named
Значение по умолчанию
Принимать входные данные из конвейера?	false
Принимать подстановочные знаки?	false

-ComputerName <string[]>

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

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

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

Обязательно?	false
Позиция?	3
Значение по умолчанию	.
Принимать входные данные из конвейера?	false
Принимать подстановочные знаки?	false

-LogName <string>

Задает имя журнала событий.

Если журнал не существует, командлет New-EventLog создает журнал и использует данное значение в свойствах Log и LogDisplayName нового журнала событий. Если журнал существует, командлет New-EventLog регистрирует новый источник для журнала событий.

Обязательно?	true
Позиция?	1
Значение по умолчанию
Принимать входные данные из конвейера?	false
Принимать подстановочные знаки?	false

-MessageResourceFile <string>

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

Обязательно?	false
Позиция?	named
Значение по умолчанию
Принимать входные данные из конвейера?	false
Принимать подстановочные знаки?	false

-ParameterResourceFile <string>

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

Обязательно?	false
Позиция?	named
Значение по умолчанию
Принимать входные данные из конвейера?	false
Принимать подстановочные знаки?	false

-Source <string[]>

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

Обязательно?	true
Позиция?	2
Значение по умолчанию
Принимать входные данные из конвейера?	false
Принимать подстановочные знаки?	false

<CommonParameters>

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

Ввод и вывод

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

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

Нет

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

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

System.Diagnostics.EventLogEntry

Примечания

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

Чтобы создать источник событий в Windows Vista, Windows XP Professional или Windows Server 2003, необходимо быть членом группы "Администраторы" на целевом компьютере.

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

Операционная система сохраняет журналы событий в виде файлов. При создании нового журнала событий соответствующий файл сохраняется в каталоге "%SystemRoot%\System32\Config" на указанном компьютере. Имя файла состоит из восьми первых символов значения свойства Log; файл имеет расширение EVT.

Пример 1

C:\PS>new-eventlog -source TestApp -logname TestLog -MessageResourceFile C:\Test\TestApp.dll

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

Пример 2

C:\PS>$file = "C:\Program Files\TestApps\NewTestApp.dll"

C:\PS> new-eventlog -computername Server01 -source NewTestApp -logname Application -MessageResourceFile $file -CategoryResourceFile $file

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

Для выполнения команды необходимо наличие файла NewTestApp.dll на компьютере Server01.

New-EventLog