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

Синтаксис

Get-AgentLog [-EndDate <DateTime>] [-Location <LocalLongFullPath>] [-StartDate <DateTime>]

Параметры

Параметр Обязательный Тип Описание

EndDate

Дополнительный

System.DateTime

Этот параметр служит для указания даты и времени окончания сбора статистики. По умолчанию используется текущее время. При вводе конкретной даты используйте краткий формат даты, определенный настроенными на локальном компьютере региональными параметрами. Например, если компьютер настроен на использование формата короткой даты мм/дд/гггг, для указания 1 марта 2006 г. введите 03/01/2006. Допускается ввод только даты, например 10/05/2005. Можно ввести дату и время. Если вместе с датой вводится время, необходимо заключить аргумент в двойные кавычки, например: "10/05/2005 5:00:00 PM".

Location

Дополнительный

Microsoft.Exchange.Data.LocalLongFullPath

Параметр Location служит для указания каталога, содержащего файлы журналов, на основе которых можно составлять отчеты об использовании. По умолчанию используется путь C:\Program Files\Microsoft\Exchange Server\TransportRoles\Logs\AgentLog. Путь к файлу необходимо вводить в двойных кавычках, например, "C:\Program Files\Microsoft\Exchange Server\TransportRoles\Logs\AgentLog".

StartDate

Дополнительный

System.DateTime

Параметр StartDate служит для указания даты и времени начала сбора статистики. По умолчанию используется текущее время. При вводе конкретной даты используйте краткий формат даты, определенный настроенными на локальном компьютере параметрами «Язык и региональные стандарты». Например, если компьютер настроен для использования короткого формата даты мм/дд/гггг, для указания 1 марта 2006 года введите 03/01/2006. Допускается ввод только даты (например, 10/05/2005) или даты и времени. Если вместе с датой вводится время, необходимо заключить аргумент в двойные кавычки, например: "10/05/2005 5:00:00 PM".

Подробное описание

Для выполнения командлета Get-AgentLog используемой учетной записи необходимо делегировать следующие полномочия:

  • членство в локальной группе администраторов.

Дополнительные сведения о разрешениях, делегировании ролей и правах, необходимых для администрирования сервера Microsoft Exchange Server 2007, см. в разделе Вопросы, связанные с разрешениями.

Типы возвращаемых данных

Объект Описание

Timestamp

Время создания записи журнала

ConnectorName

Имя CN соединителя, получившего сообщение

SessionId

IP-адрес сеанса SMTP

IPAddress

IP-адрес сервера, устанавливающего подключение

MessageId

Идентификатор сообщения Microsoft Exchange Server 2007

P1FromAddress

Адрес отправителя в данных P1 (конверт сообщения) поле заголовка сообщения

P2FromAddresses

Адрес отправителя в данных P2 (заголовок сообщения) поле заголовка сообщения

Recipients

Получатели сообщения

Agent

Имя агента, инициирующего данное действие

Event

Событие, при котором было выполнено действие

Action

Выполненное действие (целое число)

SmtpResponse

Ответ вызывающей программе, если он отправляется

Reason

Код причины, предоставленный агентом

ReasonData

Подробное описание, предоставленное агентом

Пример

В следующем образце кода возвращается отчет со статистикой, собранной с 5 октября 2005 года с 17:00 по настоящее время.

Копировать код
Get-AgentLog -StartDate "10/05/2005 5:00:00 PM"