Get-MessageTrackingReport
Этот командлет работает только в локальной среде 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
Сведения о типах возвращаемых данных, которые также называются типами выходных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип вывода пусто, командлет не возвращает данные.
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по