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
Сведения о типах возвращаемых данных, которые также называются типами выходных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип вывода пусто, командлет не возвращает данные.