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

Limit-EventLog

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

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

Синтаксис

Limit-EventLog
     [-LogName] <String[]>
     [-ComputerName <String[]>]
     [-RetentionDays <Int32>]
     [-OverflowAction <OverflowAction>]
     [-MaximumSize <Int64>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Описание

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

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

Примеры

Пример 1. Увеличение размера журнала событий

Limit-EventLog -LogName "Windows PowerShell" -MaximumSize 20KB

Эта команда увеличивает максимальный размер журнала событий Windows PowerShell на локальном компьютере до 20 480 байт (20 КБ).

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

Limit-EventLog -LogName Security -ComputerName "Server01", "Server02" -RetentionDays 7

Эта команда обеспечивает хранение событий в журнале Security на компьютерах Server01 и Server02 не менее 7 дней.

Пример 3. Изменение действия переполнения всех журналов событий

$Logs = Get-EventLog -List | ForEach {$_.log}
Limit-EventLog -OverflowAction OverwriteOlder -LogName $Logs
Get-EventLog -List

Max(K) Retain OverflowAction     Entries  Log
------ ------ --------------     -------  ---
15,168      0 OverwriteOlder       3,412  Application
512         0 OverwriteOlder           0  DFS Replication
512         0 OverwriteOlder          17  DxStudio
10,240      7 OverwriteOlder           0  HardwareEvents
512         0 OverwriteOlder           0  Internet Explorer
512         0 OverwriteOlder           0  Key Management Service
16,384      0 OverwriteOlder           4  ODiag
16,384      0 OverwriteOlder         389  OSession Security
15,168      0 OverwriteOlder      19,360  System
15,360      0 OverwriteOlder      15,828  Windows PowerShell

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

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

Параметры

-ComputerName

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

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

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

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

-Confirm

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

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

-LogName

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

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

-MaximumSize

Задает максимальный размер журналов событий в байтах. Введите значение от 64 килобайт (КБ) до 4 гигабайт (ГБ). Значение должно быть кратным 64 КБ (65 536).

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

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

-OverflowAction

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

Допустимые значения для этого параметра:

  • DoNotOverwrite: существующие записи сохраняются и новые записи удаляются.
  • OverwriteAsNeeded: Каждая новая запись перезаписывает старую запись.
  • OverwriteOlder: новые события перезаписываются старше значения, указанного свойством MinimumRetentionDays . Если в значении свойства MinimumRetentionDays нет событий старше, новые события удаляются.

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

Тип:OverflowAction
Aliases:OFA
Допустимые значения:OverwriteOlder, OverwriteAsNeeded, DoNotOverwrite
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-RetentionDays

Задает минимальный срок хранения события в журнале событий (в днях).

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

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

-WhatIf

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

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

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

None

В этот командлет нельзя передать входные данные.

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

None

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

Примечания

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

    Этот командлет изменяет свойства объекта System.Diagnostics.EventLog , представляющего классический журнал событий. Чтобы просмотреть текущие параметры свойств журнала событий, введите Get-EventLog -List.