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


Get-MessageTrackingLog

Этот командлет доступен только в локальной среде Exchange.

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

Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.

Синтаксис

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>]
   [-NetworkMessageId <String>]
   [-Source <String>]
   [-TransportTrafficType <String>]
   [<CommonParameters>]

Описание

Для транспортной службы и службы транспортировки почтовых ящиков на сервере почтовых ящиков и пограничном транспортном сервере существует уникальные журналы отслеживания сообщений. Журнал отслеживания сообщений — это CSV-файл (файл данных с разделителями-запятыми), который содержит подробные сведения об истории всех сообщений электронной почты, проходящих через отдельный сервер Exchange Server.

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

  • Дефисы удаляются из имен полей. Так, internal-message-id отображается как InternalMessageId.
  • Поле date-time отображается как Timestamp.
  • Поле recipient-address отображается как Recipients.
  • Поле sender-address отображается как Sender.

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

Вы можете записать результаты команды в файл, выбрав ConvertTo-Html или ConvertTo-Csv и добавив к команде > <filename>. Пример: Get-MessageTrackingLog -Start "03/13/2020 09:00:00" -End "03/13/2020 09:10:00" | ConvertTo-Html > "C:\My Documents\message track.html".

Для его запуска необходимо получить соответствующие разрешения. В этой статье перечислены все параметры командлета. Но некоторые из них могут быть вам не доступны, если они не включены в назначенные разрешения. Сведения о необходимых разрешениях для запуска командлетов и использования параметров в организации см. в статье Find the permissions required to run any Exchange cmdlet.

Примеры

Пример 1

Get-MessageTrackingLog -Server Mailbox01 -Start "03/13/2018 09:00:00" -End "03/15/2018 17:00:00" -Sender "john@contoso.com"

В этом примере в журналах отслеживания сообщений на сервере почтовых ящиков с именем Mailbox01 выполняется поиск сведений обо всех сообщениях, отправленных отправителем john@contoso.comс 13 марта 2018 г., 09:00 до 15 марта 2018 г., 17:00 .

Параметры

-DomainController

Параметр DomainController указывает контроллер домена, который используется этим командлетом для чтения или записи данных в Active Directory. Вы определяете контроллер домена по его полному доменному имени (FQDN). Например, dc01.contoso.com.

Параметр DomainController не поддерживается пограничными транспортными серверами. Пограничный транспортный сервер использует локальный экземпляр службы Active Directory облегченного доступа к каталогам (AD LDS) для чтения и записи данных.

Type:Fqdn
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-End

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

Используйте формат короткой даты, определенный в настройках региональных параметров на компьютере, на котором выполняется команда. Например, если компьютер настроен на использование формата короткой даты мм / дд / гггг, введите 09/01/2018, чтобы указать 1 сентября 2018 года. Допускается ввод только даты или даты и времени. Если вы вводите дату и время дня, заключите это значение в кавычки ("), например," 09/01/2018 5:00 PM ".

Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-EventId

Параметр EventId отфильтровывает записи журнала отслеживания сообщений по значению поля EventId. Значение EventId классифицирует каждое событие сообщения. Допустимые значения — DSN, Defer, Deliver, Send и Receive.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-InternalMessageId

Параметр InternalMessageId отфильтровывает записи журнала отслеживания сообщений по значению поля InternalMessageId. InternalMessageId является идентификатором сообщения, назначенным сервером Exchange Server, выполняющим текущую обработку сообщения.

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-MessageId

Параметр MessageId отфильтровывает записи журнала отслеживания сообщений по значению поля MessageId. Значение MessageId соответствует значению в поле заголовка Message-Id: сообщения. Если поле заголовка Message-ID пустое или не существует, назначается произвольное значение. Обязательно включите полную строку MessageId (которая может включать угловые скобки) и заключите значение в кавычки (например, "d9683b4c-127b-413a-ae2e-fa7dfb32c69d@contoso.com").

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-MessageSubject

Параметр MessageSubject отфильтровывает записи журнала отслеживания сообщений по значению темы сообщения. Значение параметра MessageSubject автоматически позволяет определять частичные совпадения без помощи подстановочных знаков или специальных символов. Например, если указать значение MessageSubject как sea, результаты будут содержать сообщения с Seattle в теме. По умолчанию темы сообщений хранятся в журналах отслеживания сообщений.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-NetworkMessageId

Параметр NetworkMessageId фильтрует записи журнала отслеживания сообщений по значению поля NetworkMessageId. Это поле содержит уникальное значение идентификатора сообщения, сохраняемое в различных копиях сообщения, которые могут создаваться в связи с развертыванием копий сообщения или расширением группы рассылки. В примере он имеет значение 1341ac7b13fb42ab4d4408cf7f55890f.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019

-Recipients

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

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Reference

Параметр Reference отфильтровывает записи журнала отслеживания сообщений по значению поля Reference. Поле Reference содержит дополнительные сведения об отдельных типах событий. Например, значение поля Reference для DSN-записи отслеживания сообщений содержит значение InternalMessageId для сообщения, вызвавшего отправку уведомления о доставке. Для многих типов событий значение Reference остается пустым.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-ResultSize

Параметр ResultSize указывает максимальное число возвращаемых результатов. Если требуется возвратить все результаты, отвечающие условиям запроса, используйте для этого параметра значение unlimited. Значение по умолчанию — 1000.

Type:Unlimited
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Sender

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Server

Параметр Server задает сервер Exchange, на котором следует выполнить эту команду. Можно использовать любое значение, однозначно определяющее сервер. Примеры:

  • Имя.
  • полное доменное имя;
  • различающееся имя (DN);
  • Устаревшее различающееся имя Exchange

Устаревшее различающееся имя Exchange

Type:ServerIdParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Source

Параметр Source фильтрует записи из журнала отслеживания сообщений по значению поля Source. Эти значения указывают компонент транспорта, ответственный за событие отслеживания сообщений. Дополнительные сведения см. в статье Source values in the message tracking log.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019

-Start

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

Используйте формат короткой даты, определенный в настройках региональных параметров на компьютере, на котором выполняется команда. Например, если компьютер настроен на использование формата короткой даты мм / дд / гггг, введите 09/01/2018, чтобы указать 1 сентября 2018 года. Допускается ввод только даты или даты и времени. Если вы вводите дату и время дня, заключите это значение в кавычки ("), например," 09/01/2018 5:00 PM ".

Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-TransportTrafficType

Параметр TransportTrafficType фильтрует записи журнала отслеживания сообщений по значению поля TransportTrafficType. Однако это поле не интересно для локальных организаций Exchange.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019

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

Input types

Сведения о типах входных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип ввода для командлета пустое, командлет не принимает входные данные.

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

Output types

Сведения о типах возвращаемых данных, которые также называются типами выходных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип вывода пусто, командлет не возвращает данные.