Командлет 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 с правами на просмотр.

Чтобы выполнить командлет 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