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

Синтаксис

Get-MessageTrackingLog [-DomainController <Fqdn>] [-End <DateTime>] [-EventId <String>] [-InternalMessageId <String>] [-MessageId <String>] [-MessageSubject <String>] [-Recipients <String[]>] [-Reference <String>] [-ResultSize <Unlimited>] [-Sender <String>] [-Server <ServerIdParameter>] [-Start <DateTime>]

Параметры

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

DomainController

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

Microsoft.Exchange.Data.Fqdn

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

End

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

System.DateTime

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

EventId

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

System.String

Этот параметр возвращает записи журнала отслеживания сообщений со следующими возможными категориями событий: BadMail, Defer Deliver, DSN, Expand, Fail, PoisonMessage, Receive, Redirect, Resolve, Send, Submit и Transfer.

InternalMessageId

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

System.String

Этот параметр возвращает записи журнала отслеживания сообщений со значением InternalMessagID. InternalMessageID — идентификатор сообщения, назначаемый сервером Exchange 2007, который в текущий момент обрабатывает сообщение.

Значение InternalMessageID конкретного сообщения будет разным в журналах отслеживания сообщений всех серверов Exchange 2007, задействованных в доставке этого сообщения.

MessageId

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

System.String

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

MessageSubject

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

System.String

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

Set-TransportServer <Identity> -MessageTrackingLogSubjectLoggingEnabled $false

Recipients

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

System.String[]

Этот параметр возвращает все записи журнала отслеживания сообщений с SMTP-адресами электронной почты заданного получателя. Несколько отдельных получателей, которые включены в одно сообщение, регистрируются в журнале с помощью одной записи журнала отслеживания сообщений. Получатели нераспространенной группы рассылки регистрируются в журнале с помощью SMTP-адреса электронной почты группы рассылки. Можно указать несколько получателей, используя в качестве разделителя запятую.

Reference

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

System.String

Этот параметр возвращает записи журнала отслеживания сообщений с заданным значением в поле Reference.

Поле Reference содержит дополнительные сведения для конкретных типов EventID:

  • Send Поле Reference содержит код Internet-Message-Id любых сообщений с уведомлением о доставке.

  • Transfer Поле Reference содержит код Internal-Message-Id ветвящегося сообщения.

  • DSN Поле Reference содержит код Internet-Message-Id сообщения, вызвавшего отправку уведомления о доставке.

Для всех других типов EventID поле Reference остается пустым.

ResultSize

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

Microsoft.Exchange.Data.Unlimited

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

Sender

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

System.String

Этот параметр возвращает записи журнала отслеживания сообщений с SMTP-адресом электронной почты заданного отправителя.

Server (сервер)

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

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

Этот параметр задает сервер Exchange 2007, содержащий журналы отслеживания сообщений, в которых выполняется поиск. Параметр Server может принимать для целевого сервера любое из следующих значений:

  • Имя

  • полное доменное имя;

  • Различающееся имя (DN)

  • Различающееся имя в прежнем формате Exchange

  • GUID;

Start

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

System.DateTime

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

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

Уникальный журнал отслеживания сообщений существует на каждом компьютере с установленной ролью транспортного сервера-концентратора, сервера почтовых ящиков или пограничного транспортного сервера. Журнал отслеживания сообщений — это файл значений, разделенных запятыми, который содержит подробные сведения об истории всех сообщений электронной почты, проходящих через отдельный сервер.

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

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

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

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

Типы входных данных

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

Ошибки

Ошибка Описание

 

 

Исключения

Исключения Описание

 

 

Пример

В первом примере показано, как использовать командлет Get-MessageTrackingLog для извлечения записей журнала отслеживания сообщений, созданных между 13 марта 2006 г. 9:00 и 15 марта 2006 г. 17:00 со значением Sender равным tbremer@contoso.com.

Примечание.
В этом примере применяется американский формат даты (мм/дд/гг). Используйте формат даты, который настроен на вашем компьютере Exchange Server 2007. Указываемая дата, автоматически преобразуется в формат универсального времени (UTC), который используется внутри Exchange 2007 для хранения записей в журналах отслеживания сообщений.

Во втором примере показано, как передать выходные данные командлета Get-MessageTrackingLog в сценарий Format-List для просмотра дополнительных сведений, которые доступны в журнале отслеживания сообщений.

Для получения дополнительных сведений о конвейеризации см. раздел Конвейеризация.

Для получения дополнительных сведений о работе с выходными данными команды см. раздел Работа с возвращаемыми данными команды.

Копировать код 
Get-MessageTrackingLog -Start "03/13/2006 9:00AM" -End "03/15/2006 5:00PM" -Sender "tbremer@contoso.com"
Get-MessageTrackingLog -Start "03/13/2006 9:00AM" -End "03/15/2006 5:00PM" -Sender "tbremer@contoso.com" | Format-List