Применимо к: Exchange Server 2010 SP1

Последнее изменение раздела: 2011-03-19

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

Внимание!
Операции поиска в почтовых ящиках будут выполняться на всех серверах Microsoft Exchange Server 2010 в организации Exchange, если поиск не ограничен меньшим количеством почтовых ящиков с помощью параметра SourceMailboxes.

Дополнительные сведения о функции поиска по нескольким почтовым ящикам Exchange 2010 см. в разделе Общие сведения о поиске по нескольким почтовым ящикам.

Синтаксис

New-MailboxSearch -Name <String> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-DoNotIncludeArchive <SwitchParameter>] [-EndDate <ExDateTime>] [-ExcludeDuplicateMessages <$true | $false>] [-Force <SwitchParameter>] [-IncludeUnsearchableItems <SwitchParameter>] [-Language <CultureInfo>] [-LogLevel <Suppress | Basic | Full>] [-MessageTypes <KindKeyword[]>] [-Recipients <String[]>] [-SearchDumpster <SwitchParameter>] [-SearchQuery <String>] [-Senders <String[]>] [-SourceMailboxes <RecipientIdParameter[]>] [-StartDate <ExDateTime>] [-StatusMailRecipients <RecipientIdParameter[]>] [-TargetMailbox <MailboxIdParameter>] [-WhatIf [<SwitchParameter>]]
New-MailboxSearch -Name <String> -EstimateOnly <SwitchParameter> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-DoNotIncludeArchive <SwitchParameter>] [-EndDate <ExDateTime>] [-ExcludeDuplicateMessages <$true | $false>] [-Force <SwitchParameter>] [-IncludeUnsearchableItems <SwitchParameter>] [-Language <CultureInfo>] [-LogLevel <Suppress | Basic | Full>] [-MessageTypes <KindKeyword[]>] [-Recipients <String[]>] [-SearchDumpster <SwitchParameter>] [-SearchQuery <String>] [-Senders <String[]>] [-SourceMailboxes <RecipientIdParameter[]>] [-StartDate <ExDateTime>] [-StatusMailRecipients <RecipientIdParameter[]>] [-TargetMailbox <MailboxIdParameter>] [-WhatIf [<SwitchParameter>]]

Параметры

Параметр Обязательность Тип Описание

EstimateOnly

Обязательный

System.Management.Automation.SwitchParameter

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

Name

Обязательный

System.String

Параметр Name указывает понятное имя для операции поиска. Результаты поиска копируются в папку в почтовом ящике, определенном параметром TargetMailbox. Имя папки совпадает с именем поиска.

Confirm

Необязательный

System.Management.Automation.SwitchParameter

DomainController

Необязательный

Microsoft.Exchange.Data.Fqdn

DoNotIncludeArchive

Необязательный

System.Management.Automation.SwitchParameter

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

EndDate

Необязательный

Microsoft.Exchange.ExchangeSystem.ExDateTime

Параметр EndDate указывает конечную дату и время поиска. Поиск будет выполнен по сообщениям, имеющим такую же или более раннюю дату, чем конечная дата. По умолчанию используется текущее время. При вводе конкретной даты используется краткий формат даты, определенный на локальном компьютере в разделе настроек Региональные параметры. Например, если на компьютере настроено использование краткого формата даты дд.мм.гггг, то, чтобы задать 1 марта 2006 года, введите 01.03.2006. Можно ввести только дату (например, 05.10.2005) или дату и время. Если вместе с датой вводится время, необходимо заключить аргумент в кавычки ("), например: «10/05/2005 5:00:00 PM».

ExcludeDuplicateMessages

Необязательный

System.Boolean

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

Force

Необязательный

System.Management.Automation.SwitchParameter

Параметр Force создает поиск, перезаписывающий любые существующие операции поиска под тем же именем.

IncludeUnsearchableItems

Необязательный

System.Management.Automation.SwitchParameter

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

Language

Необязательный

System.Globalization.CultureInfo

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

LogLevel

Необязательный

Microsoft.Exchange.Data.Storage.Infoworker.MailboxSearch.LoggingLevel

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

  • Suppress   Журналы не сохраняются.

  • Basic   Сохраняется основная информация о запросе и его отправителе.

  • Full   Кроме информации, сохраняемой в уровне журнала Basic, в уровне журнала Full сохраняется полный список результатов поиска.

MessageTypes

Необязательный

Microsoft.Exchange.Data.Search.AqsParser.KindKeyword[]

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

  • Email

  • Meetings

  • Tasks

  • Notes

  • Docs

  • Journals

  • Contacts

  • IM

Если тип сообщения не указан, то включаются все типы.

Recipients

Необязательный

System.String[]

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

SearchDumpster

Необязательный

System.Management.Automation.SwitchParameter

Параметр SearchDumpster включает поиск в корзине, являющейся местом хранения элементов, удаленных из папки «Удаленные», до их полного удаления из базы данных почтовых ящиков.

SearchQuery

Необязательный

System.String

Параметр SearchQuery указывает строку для поиска или запрос, отформатированный с использованием дополнительного синтаксиса запроса.

Если значение для этого параметра не задано, возвращаются все сообщения из всех почтовых ящиков, указанных в параметре SourceMailboxes.

Senders

Необязательный

System.String[]

Параметр Senders указывает SMTP-адрес одного или нескольких отправителей.

SourceMailboxes

Необязательный

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]

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

Примечание.
Если параметр не указан, проверяются все почтовые ящики в организации Exchange.

StartDate

Необязательный

Microsoft.Exchange.ExchangeSystem.ExDateTime

Параметр StartDate указывает дату и время запуска поиска.

Сведения о допустимых параметрах форматирования даты и времени см. в описании параметра EndDate.

StatusMailRecipients

Необязательный

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]

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

TargetMailbox

Необязательный

Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter

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

  • Псевдоним

  • Отображаемое имя.

  • Домен\Учетная запись

  • SMTP-адрес

  • Различающееся имя (DN)

  • Идентификатор GUID объекта

  • Имя участника-пользователя (UPN)

  • LegacyExchangeDN

WhatIf

Необязательный

System.Management.Automation.SwitchParameter

Подробное описание

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

 Запись «Поиск по нескольким почтовым ящикам» в разделе Политика обмена сообщениями и соответствие требованиям.

Типы входных данных

Типы возвращаемых данных

Ошибки

Ошибка Описание

 

 

Примеры

ПРИМЕР 1

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

  • SourceMailboxes   Этот параметр ограничивает поиск членами групп рассылки DG-Marketing и DG-Executives.

  • Recipients   Этот параметр указывает, что в поиск включаются все сообщения, отправленные на домен contoso.com.

  • SearchQuery   Этот параметр указывает запрос AQS для текстовых сообщений или отчетов, а также для сообщений с вложениями.

  • StartDate и EndDate   Эти параметры указывают дату начала периода для поиска 1 января 2005 г. и дату окончания — 31 декабря 2006 г.

  • TargetMailbox   Этот параметр указывает, что результаты поиска необходимо копировать в почтовый ящик обнаружения с именем LegalDiscovery.

  • StatusMailRecipeints   Этот параметр указывает, что после окончания поиска группа рассылки DG-DiscoveryTeam должна получить уведомление.

Скопировать код 
New-MailboxSearch -Name "Legal-ProjectX" -SourceMailboxes DG-Marketing,DG-Executives -TargetMailbox LegalDiscovery@contoso.com -StartDate "01/01/2005" -EndDate "12/31/2006" -Recipients "*@contoso.com" -SearchQuery "project report hasattachments:true" -StatusMailRecipients "DG-DiscoveryTeam"