Test-ExchangeSearch

Синтаксис

Test-ExchangeSearch
    [[-Identity] <MailboxIdParameter>]
    [-Archive]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-IndexingTimeoutInSeconds <Int32>]
    [-MonitoringContext]
    [-WhatIf]
    [<CommonParameters>]
Test-ExchangeSearch
    [-MailboxDatabase <DatabaseIdParameter>]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-IndexingTimeoutInSeconds <Int32>]
    [-MonitoringContext]
    [-WhatIf]
    [<CommonParameters>]
Test-ExchangeSearch
    [-Server <ServerIdParameter>]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-IndexingTimeoutInSeconds <Int32>]
    [-MonitoringContext]
    [-WhatIf]
    [<CommonParameters>]

Описание

Командлет Test-ExchangeSearch создает скрытое сообщение и вложение в заданном почтовом ящике, которое видимо только для поиска Exchange. Команда ожидает индексации сообщения, а затем выполняет поиск содержимого. Она сообщает об успехе или неудаче в зависимости от того, найдено ли сообщение по истечении времени, заданного в параметре IndexingTimeoutInSeconds.

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

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

Примеры

Пример 1

Test-ExchangeSearch -Identity john@contoso.com

В этом примере показано, как проверить результаты поиска Exchange для базы данных почтовых ящиков, в которой находится указанный почтовый ящик.

Пример 2

Test-ExchangeSearch -Identity john@contoso.com -Verbose

В этом примере показано, как проверить результаты поиска Exchange для базы данных почтовых ящиков, в которой находится указанный почтовый ящик. Параметр Verbose используется для вывода подробных сведений.

Параметры

-— MailboxDatabase

Этот параметр доступен или работает только в Exchange Server 2010 и 2013.

Параметр MailboxDatabase указывает базу данных почтовых ящиков для тестирования поиска в Exchange. Вы можете использовать любое значение, уникальным образом идентифицирующее базу данных. Пример:

  • имя;
  • различающееся имя (DN);
  • GUID

Этот параметр нельзя использовать вместе с параметром Identity или Server.

Type:DatabaseIdParameter
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-— Архив

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

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-— Индексингтимеаутинсекондс

Параметр IndexingTimeoutInSeconds определяет максимальный интервал времени между добавлением сообщения электронной почты в тестовый почтовый ящик и ожиданием его возвращения в результате поиска. Значение по умолчанию: 120 секунд. Если этот параметр не указан, используется интервал по умолчанию.

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-— Мониторингконтекст

Параметр MonitoringContext включает в результаты связанные события мониторинга и данные счетчиков производительности. Как правило, события мониторинга и счетчики производительности включаются в результаты, когда выходные данные передаются в Microsoft System Center Operations Manager (SCOM). С этим параметром не нужно указывать значение.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-Confirm

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

  • Деструктивные командлеты (например, Remove-* командлеты) имеют встроенную паузу, которая заставляет вас подтвердить команду перед продолжением. Можно пропускать запросы на подтверждение этих командлетов, используя следующий синтаксис: -Confirm:$false.
  • Большинство других командлетов (например, New-* и Set-*командлеты) не имеют встроенной паузы. Для этих командлетов указание переключателя Confirm без значения вводит паузу, которая заставляет вас подтвердить команду перед продолжением.
Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-Identity

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

  • Имя
  • Псевдоним
  • различающееся имя (DN);
  • Каноническое краткое имя
  • \Имя пользователя домена
  • Адрес электронной почты
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • Идентификатор пользователя или имя участника-пользователя

Этот параметр нельзя использовать с параметрами MailboxDatabase или Server.

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

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

  • Имя.
  • полное доменное имя;
  • различающееся имя (DN);
  • Устаревшее различающееся имя Exchange

Этот параметр нельзя использовать с параметром MailboxDatabase или Identity.

Type:ServerIdParameter
Position:Named
Default value:None
Accept pipeline input:True
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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

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

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

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

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