Командлет Get-MessageTrackingLog (окончательная первоначальная версия)

Статья
09/30/2014

Применимо к: Exchange Server 2007

Последнее изменение раздела: 2007-06-11

Командлет 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>]

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

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

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

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

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

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

Параметры

Параметр	Обязательность	Тип	Описание
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 для извлечения записей журнала отслеживания сообщений, созданных между 13 марта 2006 г. 9:00 и 15 марта 2006 г. 17:00 со значением Sender равным tbremer@contoso.com.

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

В этом примере применяется американский формат даты (мм/дд/гг). Используйте формат даты, который настроен на вашем компьютере 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

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