Get-MessageTrackingReport
Этот командлет работает только в локальной среде Exchange.
Используйте командлет Get-MessageTrackingReport для получения данных об определенном отчете отслеживания сообщений. Этот командлет используется функцией отчетов о доставке.
В Exchange Online вместо отчетов о доставке используется трассировка сообщений (командлеты Get-MessageTraceV2 и Get-MessageTraceDetailV2).
Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.
Синтаксис
Default (По умолчанию)
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"
foreach ($reportId in $Temp.MessageTrackingReportId) {
Get-MessageTrackingReport -Identity $reportId -ReportTemplate Summary -Status Delivered
}
В этом примере выполняется получение отчета об отслеживании сообщений, отправленных от одного пользователя к другому. В данном случае возвращается сводная таблица отчета об отслеживании сообщения, отправленного Дэвидом Джонсом (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
Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
Параметр BypassDelegateChecking позволяет специалистам службы поддержки и администраторам получать отчеты об отслеживании сообщений для любого пользователя. С этим параметром не нужно указывать значение.
По умолчанию пользователи могут просматривать отчеты об отслеживании только для сообщений, которые они отправляют или получают из своего почтового ящика. Этот параметр позволяет просматривать отчеты об отслеживании сообщений других пользователей.
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-DetailLevel
Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Параметр DetailLevel указывает объем сведений, возвращаемый в результатах. Допустимые значения:
- Базовый: возвращаются простые сведения отчета о доставке, более подходящие для пользователей.
- Подробная информация: возвращаются полные сведения отчета, включая имена серверов и сведения о физической топологии.
Свойства параметров
| Тип: | MessageTrackingDetailLevel |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-DomainController
Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Параметр DomainController указывает контроллер домена, который используется этим командлетом для чтения или записи данных в Active Directory. Вы определяете контроллер домена по его полному доменному имени (FQDN). Например, dc01.contoso.com.
Свойства параметров
| Тип: | Fqdn |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-DoNotResolve
Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
Параметр DoNotResolve запрещает преобразование адресов электронной почты в отображаемые имена. С этим параметром не нужно указывать значение.
Использование этого параметра повышает производительность, но из-за отсутствия отображаемых имен может быть труднее интерпретировать результаты.
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Identity
Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
Параметр Identity указывает идентификатор отчета об отслеживании сообщений.
Сначала необходимо выполнить командлет Search-MessageTrackingReport, чтобы найти этот идентификатор для отслеживаемого сообщения, а затем передать значение поля MessageTrackingReportID в данный параметр.
Внимание: значение $null или несуществующее значение параметра Identity возвращает все объекты так, как если бы вы выполнили команду Get- без параметра Identity. Убедитесь, что все списки значений для параметра Identity точны и не содержат несуществующих значений $null.
Свойства параметров
| Тип: | MessageTrackingReportId |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | 1 |
| Обязательно: | True |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-RecipientPathFilter
Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
Параметр RecipientPathFilter указывает адрес электронной почты получателя, когда параметр ReportTemplate используется со значением RecipientPath.
Свойства параметров
| Тип: | SmtpAddress |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Recipients
Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
Параметр Recipients указывает адреса электронной почты получателей, когда параметр ReportTemplate используется со значением Summary. Можно указать несколько адресов электронной почты, разделив их запятыми.
Свойства параметров
| Тип: | String[] |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ReportTemplate
Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
Параметр ReportTemplate указывает формат вывода данных. Допустимые значения:
- RecipientPath: Возвращает подробный отчет об отслеживании для одного получателя сообщения. Получатель указывается с помощью параметра RecipientPathFilter.
- Сводка: возвращает сводку для всех получателей сообщения. Получатели указываются с помощью параметра Recipients.
Свойства параметров
| Тип: | ReportTemplate |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ResultSize
Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
Параметр ResultSize указывает максимальное число возвращаемых результатов. Если требуется возвратить все результаты, отвечающие условиям запроса, используйте для этого параметра значение unlimited. Значение по умолчанию — 1000.
Свойства параметров
| Тип: | Unlimited |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Status
Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
Параметр Status фильтрует результаты по указанным кодам состояния доставки. Допустимые значения:
- Доставлено
- Чтение
- Pending
- Передан
- Неудачно
Свойства параметров
| Тип: | _DeliveryStatus |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-TraceLevel
Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Параметр TraceLevel указывает сведения, включаемые в результаты. Допустимые значения:
- Низкий: возвращается минимальное количество дополнительных данных, включая серверы, к которым был получен доступ, время, количество результатов поиска отслеживания сообщений и любые сведения об ошибках.
- Средний: помимо данных, возвращаемых для параметра "Низкий", возвращаются также фактические результаты поиска отслеживания сообщений.
- Высокий: возвращаются полные диагностические данные.
Этот параметр необходимо использовать только для устранения проблем с отслеживанием сообщений.
Свойства параметров
| Тип: | TraceLevel |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в статье about_CommonParameters.
Входные данные
Input types
Чтобы просмотреть типы входных данных, которые принимает этот командлет, см. Типы входных и выходных данных командлета. Если поле "Типы входных данных" для командлета пусто, командлет не принимает входные данные.
Выходные данные
Output types
Чтобы просмотреть типы возвращаемых данных, также называемые типами вывода, которые принимает этот командлет, см. раздел Типы ввода и вывода командлета. Если поле "Типы выходных данных" пусто, командлет не возвращает данные.