Применимо к: 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 указывает идентификатор почтового ящика для поиска. Ниже приведены значения, которые можно использовать.
|
||
TargetFolder |
Обязательный |
System.String |
Параметр TargetFolder задает имя папка, в которой в целевом почтовом ящике сохраняются результаты поиска. Папка создается в целевом почтовом ящике после выполнения. |
||
TargetMailbox |
Обязательный |
Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter |
Параметр TargetMailbox указывает идентификатор почтового ящика назначения, в который выполняется копирование результатов поиска. Ниже приведены значения, которые можно использовать.
При указании значения для параметра TargetMailbox необходимо также использовать параметр TargetFolder. Данный параметр невозможно использовать совместно с переключателем EstimateResultOnly. |
||
Confirm |
Необязательный |
System.Management.Automation.SwitchParameter |
Параметр Confirm приостанавливает обработку и требует указать действие, которое будет выполнено командой перед ее возобновлением. Указывать значение параметра Confirm не обязательно. |
||
DeleteContent |
Необязательный |
System.Management.Automation.SwitchParameter |
Параметр DeleteContent указывает, что сообщения,
возвращаемые при поиске, должны быть безвозвратно удалены из
исходного почтового ящика. При использовании с параметром
TargetMailbox сообщения копируются в целевой почтовый ящик и
удаляются из исходного почтового ящика. Если задать для поиска
уровень ведения журнала
|
||
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. При
значении, равном |
||
LogLevel |
Необязательный |
Microsoft.Exchange.Data.Storage.Infoworker.MailboxSearch.LoggingLevel |
Параметр LogLevel указывает уровень ведения журнала для поиска. Можно использовать одно из следующих значений:
Уровень журнала по умолчанию равен |
||
LogOnly |
Необязательный |
System.Management.Automation.SwitchParameter |
Параметр LogOnly указывает, что после поиска создается только журнал. Сообщения, возвращенные в ходе поиска, не копируются в целевой почтовый ящик. Уровень ведения журнала задается параметром LogLevel. |
||
SearchDumpster |
Необязательный |
System.Management.Automation.SwitchParameter |
Параметр SearchDumpster указывает, ведется ли поиск в
папке элементов для восстановления, являющейся местом хранения
элементов, удаленных из папки «Удаленные» или удаленных без
возможности восстановления, до их окончательного удаления из базы
данных почтовых ящиков. По умолчанию поиск в этой папке всегда
ведется. Чтобы исключить папку из области поиска, задайте для
параметра SearchDumpster значение |
||
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 |