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

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

Командлет Search-Mailbox используется для поиска по почтовым ящикам и копирования результатов в указанный целевой почтовый ящик, удаления сообщений из исходного почтового ящика или обеих задач сразу.

Синтаксис

Search-Mailbox -Identity <MailboxOrMailUserIdParameter> [-Confirm [<SwitchParameter>]] [-DeleteContent <SwitchParameter>] [-DomainController <Fqdn>] [-DoNotIncludeArchive <SwitchParameter>] [-Force <SwitchParameter>] [-IncludeUnsearchableItems <SwitchParameter>] [-SearchDumpster <SwitchParameter>] [-SearchDumpsterOnly <SwitchParameter>] [-SearchQuery <String>] [-WhatIf [<SwitchParameter>]]
Search-Mailbox -Identity <MailboxOrMailUserIdParameter> -TargetFolder <String> -TargetMailbox <MailboxIdParameter> [-Confirm [<SwitchParameter>]] [-DeleteContent <SwitchParameter>] [-DomainController <Fqdn>] [-DoNotIncludeArchive <SwitchParameter>] [-Force <SwitchParameter>] [-IncludeUnsearchableItems <SwitchParameter>] [-LogLevel <Suppress | Basic | Full>] [-LogOnly <SwitchParameter>] [-SearchDumpster <SwitchParameter>] [-SearchDumpsterOnly <SwitchParameter>] [-SearchQuery <String>] [-WhatIf [<SwitchParameter>]]
Search-Mailbox -Identity <MailboxOrMailUserIdParameter> -EstimateResultOnly <SwitchParameter> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-DoNotIncludeArchive <SwitchParameter>] [-Force <SwitchParameter>] [-IncludeUnsearchableItems <SwitchParameter>] [-SearchDumpster <SwitchParameter>] [-SearchDumpsterOnly <SwitchParameter>] [-SearchQuery <String>] [-WhatIf [<SwitchParameter>]]

Параметры

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

EstimateResultOnly

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

System.Management.Automation.SwitchParameter

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

Identity

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

Microsoft.Exchange.Configuration.Tasks.MailboxOrMailUserIdParameter

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

  • Псевдоним

  • Краткое имя

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

  • SMTP-адрес

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

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

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

  • LegacyExchangeDN

TargetFolder

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

System.String

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

TargetMailbox

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

Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter

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

  • Псевдоним

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

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

  • SMTP-адрес

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

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

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

  • LegacyExchangeDN

При указании значения для параметра TargetMailbox необходимо также использовать параметр TargetFolder. Данный параметр невозможно использовать совместно с переключателем EstimateResultOnly.

Confirm

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

System.Management.Automation.SwitchParameter

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

DeleteContent

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

System.Management.Automation.SwitchParameter

Параметр DeleteContent указывает, что сообщения, возвращаемые при поиске, должны быть безвозвратно удалены из исходного почтового ящика. При использовании с параметром TargetMailbox сообщения копируются в целевой почтовый ящик и удаляются из исходного почтового ящика. Если задать для поиска уровень ведения журнала Basic или Full, следует указать целевой почтовый ящик и целевую папку, в которой будет создан журнал. Чтобы удалить сообщения из исходного ящика без копирования в целевой почтовый ящик, не задавайте значения параметров TargetMailbox, TargetFolder и LogLevel.

Важно!
Перед использованием параметра DeleteContent для удаления содержимого рекомендуется проверить параметры подключения с помощью параметра LogOnly, как показано в примере 2.

DomainController

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

Microsoft.Exchange.Data.Fqdn

Параметр DomainController указывает имя FQDN контроллера домена, который записывает это изменение конфигурации в Служба каталогов Active Directory.

DoNotIncludeArchive

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

System.Management.Automation.SwitchParameter

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

Force

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

System.Management.Automation.SwitchParameter

Параметр Force подавляет запрос на подтверждение при использовании параметра DeleteContent для безвозвратного удаления сообщений.

IncludeUnsearchableItems

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

System.Management.Automation.SwitchParameter

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

LogLevel

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

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

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

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

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

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

Уровень журнала по умолчанию равен Basic.

LogOnly

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

System.Management.Automation.SwitchParameter

Параметр LogOnly указывает, что после поиска создается только журнал. Сообщения, возвращенные в ходе поиска, не копируются в целевой почтовый ящик. Уровень ведения журнала задается параметром LogLevel.

SearchDumpster

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

System.Management.Automation.SwitchParameter

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

SearchDumpsterOnly

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

System.Management.Automation.SwitchParameter

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

SearchQuery

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

System.String

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

Если параметр не задан, возвращаются все сообщения.

WhatIf

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

System.Management.Automation.SwitchParameter

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

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

Командлет Search-Mailbox можно использовать для поиска сообщений в заданном почтовом ящике и выполнения любой из следующих задач:

Для запуска этого командлета необходимы соответствующие разрешения. В этом разделе перечислены все параметры командлета, однако некоторые из них могут быть недоступны, если они не включены в назначенные разрешения. Сведения о необходимых разрешениях см. в разделе Запись «Поиск в нескольких почтовых ящиках» в разделе Политика обмена сообщениями и соответствие требованиям.

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

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

Ошибки

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

 

 

Примеры

ПРИМЕР 1

В этом примере производится поиск по почтовому ящику Станислава Песоцкого и копируются результаты поиска в почтовый ящик DiscoveryMailbox в папку «Станислав_Песоцкий-Проект_Гамильтон».

Скопировать код
Search-Mailbox -Identity "Joe Healy" -SearchQuery "Subject:Project Hamilton" -TargetMailbox "DiscoveryMailbox" -TargetFolder "JoeHealy-ProjectHamilton" -LogLevel Full 

ПРИМЕР 2

В этом примере ведется поиск по почтовому ящику «April Stewart» с отбором сообщений, содержащих фразу «Your bank statement» в теме; результаты заносятся в папку SearchAndDeleteLog почтового ящика администратора. В целевой почтовый ящик сообщения не копируются.

Скопировать код
Search-Mailbox -Identity "April Stewart" -SearchQuery 'Subject:"Your bank statement"' -TargetMailbox "administrator" -TargetFolder "SearchAndDeleteLog" -LogOnly -LogLevel Full

ПРИМЕР 3

В этом примере ведется поиск по почтовому ящику «April Stewart» с отбором сообщений, содержащих фразу «Your bank statement» в теме; сообщения удаляются из исходного почтового ящика.

Скопировать код
Search-Mailbox -Identity "April Stewart" -SearchQuery 'Subject:"Your bank statement"' -DeleteContent