Start-MailboxSearch

Этот командлет доступен в локальной среде Exchange и в облачной службе. Некоторые параметры и настройки могут отличаться в зависимости от среды.

Командлет Start-MailboxSearch используется для запуска или возобновления остановленного поиска в почтовых ящиках.

Примечание. По состоянию на октябрь 2020 г. командлеты *-MailboxSearch не используются в Exchange Online PowerShell. Вместо этого используйте командлеты *-ComplianceSearch в PowerShell для соответствия требованиям безопасности & . Дополнительные сведения см. в статье Прекращение использования устаревших средств обнаружения электронных данных.

Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.

Синтаксис

Start-MailboxSearch
     [-Identity] <SearchObjectIdParameter>
     [-Confirm]
     [-DomainController <Fqdn>]
     [-Force]
     [-Resume]
     [-StatisticsStartIndex <Int32>]
     [-WhatIf]
     [<CommonParameters>]

Описание

Вы можете использовать In-Place eDiscovery для поиска одного или нескольких указанных почтовых ящиков или всех почтовых ящиков в организации Exchange. Поиск создается с помощью Центра администрирования Exchange (EAC) или командлета New-MailboxSearch.

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

В Exchange 2013 или более поздних версиях поиск в почтовых ящиках также используется для In-Place удержания. Тем не менее невозможно запускать и прекращать хранение на месте с помощью командлетов Start-MailboxSearch и Stop-MailboxSearch.

Дополнительные сведения см. в разделах Удержание на месте и удержание в судебном процессе в Exchange Server и обнаружение электронных данных на месте в Exchange Server.

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

Примеры

Пример 1

Start-MailboxSearch -Identity "ProjectContoso"

В этом примере запускается поиск по почтовому ящику с именем ProjectContoso.

Параметры

-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

-Force

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

Этот параметр можно применять для программного выполнения задач, не требующего вмешательства администратора.

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 указывает имя поиска. Это имя используется при запуске, остановке или удалении поиска.

Type:SearchObjectIdParameter
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

-Resume

Параметр Resume позволяет возобновить остановленный, сбойный или частично успешный поиск с точки остановки. Для этого переключателя не требуется указывать значение.

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

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

-StatisticsStartIndex

Параметр StatisticsStartIndex используется в EAC для извлечения статистики ключевых слов при работе с несколькими страницами.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-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

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