Search-MessageTrackingReport
Этот командлет работает только в локальной среде Exchange.
Используйте командлет Search-MessageTrackingReport для нахождения уникального отчета отслеживания сообщений на основе указанного критерия поиска. Идентификатор этого отчета затем можно передать в командлет Get-MessageTrackingReport для получения полной информации об отслеживании сообщения. Дополнительные сведения см. в разделе Get-MessageTrackingReport. Командлеты отчетов отслеживания сообщений используются в отчетах о доставке.
В Exchange Online отчеты о доставке заменены трассировками сообщений (командлеты Get-MessageTrace и Get-MessageTraceDetail).
Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.
Синтаксис
Search-MessageTrackingReport
[-Identity] <MailboxIdParameter>
-Sender <SmtpAddress>
[-BypassDelegateChecking]
[-Confirm]
[-DomainController <Fqdn>]
[-DoNotResolve]
[-MessageEntryId <String>]
[-MessageId <String>]
[-ResultSize <Unlimited>]
[-Subject <String>]
[-TraceLevel <TraceLevel>]
[-WhatIf]
[<CommonParameters>] Search-MessageTrackingReport
[-Identity] <MailboxIdParameter>
[-Recipients <SmtpAddress[]>]
[-BypassDelegateChecking]
[-Confirm]
[-DomainController <Fqdn>]
[-DoNotResolve]
[-MessageEntryId <String>]
[-MessageId <String>]
[-ResultSize <Unlimited>]
[-Subject <String>]
[-TraceLevel <TraceLevel>]
[-WhatIf]
[<CommonParameters>] Описание
Для его запуска необходимо получить соответствующие разрешения. В этой статье перечислены все параметры командлета. Но некоторые из них могут быть вам не доступны, если они не включены в назначенные разрешения. Сведения о необходимых разрешениях для запуска командлетов и использования параметров в организации см. в статье Find the permissions required to run any Exchange cmdlet.
Примеры
Пример 1
Search-MessageTrackingReport -Identity "David Jones" -Recipients "wendy@contoso.com"В этом примере в отчете об отслеживании сообщений выполняется поиск сообщений, отправленных от одного пользователя к другому. В данном случае возвращается отчет об отслеживании сообщения, отправленного Дэвидом Джонсом (David Jones) пользователю Венди Ричардсон (Wendy Richardson).
Пример 2
Search-MessageTrackingReport -Identity "Cigdem Akin" -Sender "joe@contoso.com" -BypassDelegateChecking -DoNotResolveВ этом примере выполняется поиск в отчете об отслеживании сообщений для следующего сценария: пользователь 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 |
-Confirm
Переключатель подтверждения указывает, показывать или скрывать запрос подтверждения. Влияние этого параметра на командлет зависит от того, требуется ли командлету подтверждение перед выполнением.
- Деструктивные командлеты (например, командлеты Remove-*) имеют встроенную паузу, которая заставляет вас подтвердить команду перед продолжением. Можно пропускать запросы на подтверждение этих командлетов, используя следующий синтаксис:
-Confirm:$false. - Большинство других командлетов (например, командлеты New-* и Set-*) не имеют встроенной приостановки. Для этих командлетов указание переключателя Confirm без значения вводит паузу, которая заставляет вас подтвердить команду перед продолжением.
| Type: | SwitchParameter |
| Aliases: | cf |
| 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 |
-DomainController
Этот параметр доступен только в локальной среде Exchange.
Параметр 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 ограничивает поиск указанным почтовым ящиком. Вы можете использовать любое значение, которое однозначно определяет почтовый ящик. Пример.
- Имя
- Псевдоним
- различающееся имя (DN);
- различающееся имя (DN);
- Домен\Имя пользователя
- Адрес электронной почты
- GUID
- LegacyExchangeDN
- SamAccountName
- Идентификатор пользователя или имя участника-пользователя
При использовании этого параметра без параметра Sender указанный почтовый ящик является отправителем сообщения, используемым в поиске. Получателей можно указывать с помощью параметра Recipients.
Когда этот параметр используется с параметром Sender, указанный почтовый ящик — это получатель сообщения, используемый в поиске.
| Type: | MailboxIdParameter |
| 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 |
-MessageEntryId
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
| 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 |
-MessageId
Параметр MessageId фильтрует результаты по полю темы Message-ID сообщения. Это значение еще зовется идентификатором клиента. Формат Message-ID зависит от сервера обмена сообщениями, с которого было отправлено сообщение. Значение должно быть уникальным для каждого сообщения. Но не все серверы обмена сообщениями создают значения для параметра Message-ID одинаковым способом. Обязательно включите полную строку идентификатора сообщения (которая может включать угловые скобки) и заключите значение в кавычки (например, "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, Exchange Online |
-Recipients
Параметр Recipients фильтрует результаты по адресам электронной почты указанных получателей. Можно указать несколько адресов электронной почты, разделив их запятыми.
Этот параметр нельзя использовать вместе с параметром Sender.
| 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 |
-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 |
-Sender
Параметр Sender указывает адрес электронной почты, с которого отправляются сообщения в почтовый ящик, заданный параметром Identity.
Этот параметр необходимо использовать вместе с параметром Identity.
| Type: | SmtpAddress |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Subject
Параметр Subject ищет сообщения с указанным значением поля Subject. Если значение содержит пробелы, необходимо заключить его в кавычки.
| 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 |
-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 |
-WhatIf
Переключатель WhatIf имитирует действия команды. Вы можете использовать его для просмотра результатов изменений без фактического внесения этих изменений. С этим параметром не нужно указывать значение.
| Type: | SwitchParameter |
| Aliases: | wi |
| 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 |
Входные данные
Input types
Сведения о типах входных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип ввода для командлета пустое, командлет не принимает входные данные.
Выходные данные
Output types
Сведения о типах возвращаемых данных, которые также называются типами выходных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип вывода пусто, командлет не возвращает данные.
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по