Search-MessageTrackingReport

Ссылка

Модуль:: ExchangePowerShell

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

Этот командлет работает только в локальной среде 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

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

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