New-MailboxSearch

Ссылка

Модуль:: ExchangePowerShell

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

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

Используйте командлет New-MailboxSearch, чтобы создать запрос на поиск в почтовых ящиках и получить информацию о результатах, назначить для последних удержание на месте или скопировать их в почтовый ящик найденных сообщений. Вы также можете поместить на удержание все содержимое почтового ящика, не указывая поисковый запрос (что соответствует хранению для судебного разбирательства).

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

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

Синтаксис

New-MailboxSearch
   [-Name] <String>
   [-AllPublicFolderSources <Boolean>]
   [-AllSourceMailboxes <Boolean>]
   [-Confirm]
   [-Description <String>]
   [-DomainController <Fqdn>]
   [-DoNotIncludeArchive]
   [-EndDate <ExDateTime>]
   [-EstimateOnly]
   [-ExcludeDuplicateMessages <Boolean>]
   [-Force]
   [-IncludeKeywordStatistics]
   [-IncludeUnsearchableItems]
   [-InPlaceHoldEnabled <Boolean>]
   [-InPlaceHoldIdentity <String>]
   [-ItemHoldPeriod <Unlimited>]
   [-Language <CultureInfo>]
   [-LogLevel <LoggingLevel>]
   [-MessageTypes <KindKeyword[]>]
   [-Recipients <String[]>]
   [-SearchDumpster]
   [-SearchQuery <String>]
   [-Senders <String[]>]
   [-SourceMailboxes <RecipientIdParameter[]>]
   [-StartDate <ExDateTime>]
   [-StatusMailRecipients <RecipientIdParameter[]>]
   [-TargetMailbox <MailboxIdParameter>]
   [-WhatIf]
   [<CommonParameters>]

Описание

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

По умолчанию поиск в почтовых ящиках выполняется на всех серверах почтовых ящиков Exchange 2013 или более поздних версий в организации, если вы не ограничиваете поиск меньшим количеством почтовых ящиков с помощью параметра SourceMailboxes. Чтобы выполнить поиск почтовых ящиков на серверах почтовых ящиков Exchange 2010, выполните команду на сервере Exchange 2010.

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

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

Примеры

Пример 1

New-MailboxSearch -Name "Legal-ProjectX" -SourceMailboxes DG-Marketing,DG-Executives -TargetMailbox LegalDiscovery@contoso.com -StartDate "01/01/2018" -EndDate "12/31/2018" -Recipients "@contoso.com" -SearchQuery "project report hasattachments:true" -StatusMailRecipients "DG-DiscoveryTeam"

В этом примере создается запрос на поиск в почтовых ящиках Legal-ProjectX. Этот запрос ограничен несколькими параметрами:

SourceMailboxes: этот параметр ограничивает поиск членами DG-Marketing и DG-Executives групп рассылки.
Получатели. Этот параметр указывает, что поиск включает в себя всю почту, отправляемую в домен contoso.com.
SearchQuery: этот параметр задает KQL-запрос для сообщений со словами project или report, а также для сообщений с вложениями.
StartDate и EndDate: эти параметры указывают дату начала 1 января 2018 г. и дату окончания 31 декабря 2018 г. для поиска.
TargetMailbox: этот параметр указывает, что результаты поиска должны быть скопированы в почтовый ящик обнаружения LegalDiscovery.
StatusMailRecipients: этот параметр указывает, что группа рассылки DG-DiscoveryTeam будет получать уведомление о завершении поиска.

Пример 2

New-MailboxSearch -Name "Hold-ProjectX" -SourceMailboxes DG-Finance -InPlaceHoldEnabled $true

В этом примере создается удержание In-Place с именем Hold-ProjectX и помещает всех членов группы рассылки DG-Finance на удержание. Поскольку при поиске не указаны значения параметров SearchQuery и ItemHoldPeriod, все сообщения на возвращенных почтовых ящиках помещаются в неопределенное удержание на месте.

Пример 3

New-MailboxSearch -Name "Hold-tailspintoys" -SourceMailboxes DG-Research -SearchQuery '"Patent" AND "Project tailspintoys"' -InPlaceHoldEnabled $true

В этом примере создается In-Place Hold-tailspintoys и помещает всех членов группы рассылки DG-Research на удержание. Поскольку при поиске параметру SearchQuery задано значение, в неопределенное удержание на месте помещаются только те сообщения, которые соответствуют поисковому запросу.

Пример 4

New-MailboxSearch -Name "Hold for all PFs" -AllPublicFolderSources $true -InPlaceHoldEnabled $true

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

Параметры

-AllPublicFolderSources

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

$true. Все общедоступные папки включаются в поиск. Это значение является обязательным, если значение параметра AllSourceMailboxes $false и вы не указываете один или несколько исходных почтовых ящиков с помощью параметра SourceMailboxes (значение параметра пустое [$null]).
$false: в поиск не включаются общедоступные папки. Это значение используется по умолчанию. Это значение можно использовать, если значение параметра AllSourceMailboxes $true или указать один или несколько исходных почтовых ящиков с помощью параметра SourceMailboxes (значение параметра не является пустым [$null]).

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

-AllSourceMailboxes

Параметр AllSourceMailboxes указывает, следует ли включать в поиск все почтовые ящики. Допустимые значения:

$true. Все почтовые ящики включаются в поиск. Это значение является обязательным, если значение параметра AllPublicFolderSources $false и вы не указываете один или несколько исходных почтовых ящиков с помощью параметра SourceMailboxes (значение параметра пустое [$null]).
$false. Все почтовые ящики не включаются в поиск. Это значение используется по умолчанию. Это значение можно использовать, если значение параметра AllPublicFolderSources $true или указать один или несколько исходных почтовых ящиков с помощью параметра SourceMailboxes (значение параметра не является пустым [$null]).

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	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, Exchange Online Protection

-Description

Параметр Description указывает описание для поиска. Описание не видно пользователям. Если значение содержит пробелы, его необходимо заключить в кавычки (").

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

-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

-DoNotIncludeArchive

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

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

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-EndDate

Параметр EndDate указывает дату окончания из диапазона дат.

Используйте формат короткой даты, определенный в настройках региональных параметров на компьютере, на котором выполняется команда. Например, если компьютер настроен на использование формата короткой даты мм / дд / гггг, введите 09/01/2018, чтобы указать 1 сентября 2018 года. Допускается ввод только даты или даты и времени. Если вы вводите дату и время дня, заключите это значение в кавычки ("), например," 09/01/2018 5:00 PM ".

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

-EstimateOnly

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

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

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

-ExcludeDuplicateMessages

Параметр ExcludeDuplicateMessages исключает дублирование сообщений в результатах поиска. Допустимые значения:

$true. Скопируйте один экземпляр сообщения, если одно и то же сообщение существует в нескольких папках или почтовых ящиках. Это значение используется по умолчанию.
$false. Скопируйте все экземпляры сообщения, если одно и то же сообщение существует в нескольких папках или почтовых ящиках.

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

-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

-IncludeKeywordStatistics

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

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

-IncludeUnsearchableItems

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

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

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

-InPlaceHoldEnabled

Параметр InPlaceHoldEnabled указывает, следует ли включить удержание на месте для результатов поиска. Допустимые значения:

$true: в результатах поиска включена In-Place удержание.
$false: In-Place удержание не включено в результатах поиска. Это значение используется по умолчанию.

Для результатов поиска невозможно включить удержание на месте, если параметру AllSourceMailboxes задано значение $true.

Если вы попытаелись разместить удержание, но не укажите почтовые ящики с помощью параметра SourceMailboxes, команда может завершиться успешной, но почтовые ящики не помещаются в In-Place удержание.

Type:	Boolean
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, Exchange Online Protection

-InPlaceHoldIdentity

Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.

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

-ItemHoldPeriod

Параметр ItemHoldPeriod указывает срок удержания на месте для элементов почтовых ящиков (всех элементов или результатов поиска). Срок указывается в днях и отсчитывается с момента получения или создания элемента в почтовом ящике. Допустимые значения:

Параметр SyncSchedule указывает ???. Допустимые значения этого параметра:
Значение unlimited. Это значение используется по умолчанию. Элементы хранятся до тех пор, пока вы не удалите In-Place Удержание путем удаления поиска с помощью командлета Remove-MailboxSearch, исходного почтового ящика из поиска с помощью командлета Set-MailboxSearch и параметра SourceMailboxes, а в локальной среде Exchange все общедоступные папки из поиска удаляются с помощью командлета Set-MailboxSearch для изменения параметра AllPublicFolderSources с $true на $false.

Type:	Unlimited
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, Exchange Online Protection

-Language

Параметр Language указывает языковой стандарт для поиска.

Допустимые входные данные для этого параметра — это поддерживаемое значение кода языка и региональных параметров из класса Майкрософт платформа .NET Framework CultureInfo. Например, da-DK для датского языка или ja-JP для японского. Дополнительные сведения см. в разделе Класс CultureInfo.

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

-LogLevel

Параметр LogLevel указывает уровень ведения журнала для поиска. Допустимые значения:

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

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

-MessageTypes

Параметр MessageTypes указывает типы сообщений, которые следует включить в поисковый запрос. Допустимые значения:

Контакты
Docs
Электронная почта
"IM" (Обмен мгновенными сообщениями);
Журналы
Собрания
Примечания
Задачи

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

Значение по умолчанию — $null, т. е. включаются все типы сообщений.

Type:	KindKeyword[]
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

-Name

Параметр Name указывает понятное имя для поиска. Если значение содержит пробелы, его необходимо заключить в кавычки (").

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

Type:	String
Position:	1
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

-Recipients

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

Вы можете указать нескольких получателей через запятую.

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

-SearchDumpster

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

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

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

Type:	SwitchParameter
Position:	Named
Default value:	True
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-SearchQuery

Параметр SearchQuery определяет ключевые слова поискового запроса с помощью KQL. Дополнительные сведения см. в статье Справочник по синтаксису языка запросов ключевых слов (KQL) и Запросы ключевых слов и условия поиска для обнаружения электронных данных.

Если этот параметр используется с другими параметрами поискового запроса, они объединяются с помощью оператора AND.

Другие параметры поискового запроса:

EndDate
MessageTypes
Получатели
Отправители
StartDate

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

-Senders

Параметр Senders указывает одного или нескольких отправителей, которых следует включить в поисковый запрос. Сообщения, которые содержат указанного отправителя, возвращаются в результатах поиска. Отправителями могут быть пользователи, группы рассылки (в случае сообщений, отправленных участниками группы), SMTP-адреса и домены.

Вы можете указать несколько отправителей через запятую. Если значение содержит пробелы, его необходимо заключить в кавычки (").

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

-SourceMailboxes

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

Имя
Псевдоним
различающееся имя (DN);
различающееся имя (DN);
Каноническое краткое имя
GUID

Update Если значения содержат пробелы или иным образом требуют кавычек, используйте следующий синтаксис: "Value1","Value2",..."ValueN".

Чтобы использовать этот параметр, параметр AllSourceMailboxes должен быть $false (значение по умолчанию).

Значение по умолчанию пусто ($null), что означает, что исходные почтовые ящики не указаны. Чтобы очистить исходные почтовые ящики, используйте значение $null.

Чтобы включить In-Place удержание результатов поиска, необходимо задать для параметра AllSourceMailboxes значение $false (значение по умолчанию) и настроить один или оба следующих параметра:

Укажите один или несколько исходных почтовых ящиков с помощью параметра SourceMailboxes.
В локальной среде Exchange задайте для параметра AllPublicFolderSources значение $true.

Type:	RecipientIdParameter[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-StartDate

Параметр StartDate указывает дату начала из диапазона дат.

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

-StatusMailRecipients

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

Имя
Псевдоним
различающееся имя (DN);
различающееся имя (DN);
Каноническое краткое имя
GUID

Type:	RecipientIdParameter[]
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

-TargetMailbox

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

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

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

-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, Exchange Online Protection

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

Input types

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

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

Output types

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