Get-MessageTrackingReport

Ссылка

Модуль:: ExchangePowerShell

Применяется к:: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

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

Используйте командлет Get-MessageTrackingReport для получения данных об определенном отчете отслеживания сообщений. Этот командлет используется функцией отчетов о доставке.

В Exchange Online отчеты о доставке заменены трассировками сообщений (командлеты Get-MessageTrace и Get-MessageTraceDetail).

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

Синтаксис

Get-MessageTrackingReport
   [-Identity] <MessageTrackingReportId>
   [-BypassDelegateChecking]
   [-DetailLevel <MessageTrackingDetailLevel>]
   [-DomainController <Fqdn>]
   [-DoNotResolve]
   [-RecipientPathFilter <SmtpAddress>]
   [-Recipients <String[]>]
   [-ReportTemplate <ReportTemplate>]
   [-ResultSize <Unlimited>]
   [-Status <DeliveryStatus>]
   [-TraceLevel <TraceLevel>]
   [<CommonParameters>]

Описание

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

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

Примеры

Пример 1

$Temp = Search-MessageTrackingReport -Identity "David Jones" -Recipients "wendy@contoso.com"

Get-MessageTrackingReport -Identity $Temp.MessageTrackingReportID -ReportTemplate Summary

В этом примере выполняется получение отчета об отслеживании сообщений, отправленных от одного пользователя к другому. В данном случае возвращается сводная таблица отчета об отслеживании сообщения, отправленного Дэвидом Джонсом (David Jones) пользователю Венди Ричардсон (Wendy Richardson).

Пример 2

Search-MessageTrackingReport -Identity "Cigdem Akin" -Sender "joe@contoso.com" -ByPassDelegateChecking -DoNotResolve | ForEach-Object { Get-MessageTrackingReport -Identity $_.MessageTrackingReportID -DetailLevel Verbose -BypassDelegateChecking -DoNotResolve -RecipientPathFilter "cigdem@fabrikam.com" -ReportTemplate RecipientPath }

В этом примере возвращается отчет об отслеживании сообщений для следующего сценария: пользователь Cigdem Akin ожидал сообщения электронной почты, которое joe@contoso.com никогда не поступило. Она обратилась в службу поддержки, которая должна создать отчет о отслеживании сообщений от имени Cigdem и не должна видеть отображаемые имена.

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

Параметры

-BypassDelegateChecking

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

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

Type:	SwitchParameter
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, Exchange Online

-DetailLevel

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

Базовый: возвращаются простые сведения о доставке, что больше подходит для пользователей.
Подробные: возвращаются полные сведения отчета, включая имена серверов и сведения о физической топологии.

Type:	MessageTrackingDetailLevel
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

-DomainController

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

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

-DoNotResolve

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

Использование этого параметра повышает производительность, но из-за отсутствия отображаемых имен может быть труднее интерпретировать результаты.

Type:	SwitchParameter
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, Exchange Online

-Identity

Параметр Identity указывает идентификатор отчета об отслеживании сообщений.

Сначала необходимо выполнить командлет Search-MessageTrackingReport, чтобы найти этот идентификатор для отслеживаемого сообщения, а затем передать значение поля MessageTrackingReportID в данный параметр.

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

-RecipientPathFilter

Параметр RecipientPathFilter указывает адрес электронной почты получателя, когда параметр ReportTemplate используется со значением RecipientPath.

Type:	SmtpAddress
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, Exchange Online

-Recipients

Параметр Recipients указывает адреса электронной почты получателей, когда параметр ReportTemplate используется со значением Summary. Можно указать несколько адресов электронной почты, разделив их запятыми.

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, Exchange Online

-ReportTemplate

Параметр ReportTemplate указывает формат вывода данных. Допустимые значения:

RecipientPath. Возвращает подробный отчет об отслеживании для одного получателя сообщения. Получатель указывается с помощью параметра RecipientPathFilter.
Сводка. Возвращает сводку для всех получателей сообщения. Получатели указываются с помощью параметра Recipients.

Type:	ReportTemplate
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, Exchange Online

-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, Exchange Online

-Status

Параметр Status фильтрует результаты по указанным кодам состояния доставки. Допустимые значения:

Доставлено
Чтение
Pending
Переданы
Неудачных

Type:	_DeliveryStatus
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, Exchange Online

-TraceLevel

Параметр TraceLevel указывает сведения, включаемые в результаты. Допустимые значения:

Низкий. Возвращается минимальное количество дополнительных данных, включая серверы, к которым был предоставлен доступ, время, количество результатов поиска отслеживания сообщений и любые сведения об ошибках.
Средний. В дополнение к данным, возвращаемым для параметра Low, также возвращаются фактические результаты поиска отслеживания сообщений.
Высокий: возвращаются полные диагностические данные.

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

Type:	TraceLevel
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

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

Input types

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

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

Output types

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

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