Поделиться через


Командлет Export-Mailbox (окончательная первоначальная версия)

 

Применимо к: Exchange Server 2007

Последнее изменение раздела: 2007-06-05

Командлет Export-Mailbox используется для перемещения содержимого почтового ящика в указанную папку почтового ящика.

Синтаксис

export-Mailbox -Identity <MailboxIdParameter> -TargetFolder <String> -TargetMailbox <MailboxIdParameter> [-AllContentKeywords <String[]>] [-AttachmentFilenames <String[]>] [-BadItemLimit <Int32>] [-ContentKeywords <String[]>] [-DeleteContent <SwitchParameter>] [-EndDate <DateTime>] [-ExcludeFolders <MapiFolderPath[]>] [-GlobalCatalog <Fqdn>] [-IncludeFolders <MapiFolderPath[]>] [-Locale <CultureInfo>] [-MaxThreads <Int32>] [-ReportFile <LocalLongFullPath>] [-StartDate <DateTime>] [-SubjectKeywords <String[]>] [-ValidateOnly <SwitchParameter>]

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

Для выполнения командлета Export-Mailbox используемой учетной записи необходимо делегировать следующее:

  • роль администратора сервера Exchange Server и членство в локальной группе администраторов на целевом сервере.

Дополнительные сведения о разрешениях, делегировании ролей и правах, необходимых для администрирования Exchange Server 2007, см. в разделе Вопросы, связанные с разрешениями.

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

Командлет Export-Mailbox экспортирует все пустые папки и специальные папки в целевое расположение. Специальные папки перечислены ниже:

  • Inbox

  • Удаленные

  • Drafts

  • Нежелательная почта

  • Outbox

  • Отправленные

  • Journal

  • Календарь

  • контакты;

  • Notes

  • Задачи

Командлет Export-Mailbox также экспортирует сообщения из корзины. Дополнительные сведения о сообщениях в корзине см. в разделе Указания по восстановлению удаленного элемента.

Параметры

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

Идентификатор

Обязательность

Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter

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

  • псевдоним.

  • SMTP-адрес

  • краткое имя

Если объект команды Get-Mailbox передается другой команде по конвейеру, этот параметр не является обязательным.

TargetFolder

Обязательность

System.String

Параметр TargetFolder задает папку почтового ящика верхнего уровня, которая создается в почтовом ящике, указанном в параметре TargetMailbox. Эта папка содержит вложенную папку Recovered Data — <псевдоним исходного почтового ящика> <отметка даты и времени>. В этой вложенной папке содержатся экспортированные данные. Если указанная целевая папка уже существует в целевом почтовом ящике, экспортируемые данные будут добавлены в нее. Если целевая папка отсутствует, она будет создана.

TargetMailbox

Обязательность

Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter

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

AllContentKeywords

Дополнительно

System.String[]

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

noteПримечание.
Это отличается от использования параметров ContentKeywords и SubjectKeywords. При использовании обоих параметров ContentKeywords и SubjectKeywords команда экспортирует только те сообщения, которые содержат как ключевое слово, указанное для параметра ContentKeywords, в тексте сообщения или содержимом вложения, так и ключевое слово, указанное для параметра SubjectKeywords, в поле «Тема».

AttachmentFilenames

Дополнительно

System.String[]

Параметр AttachmentFilenames используется для указания фильтра для вложений. В строке можно использовать подстановочные знаки. Например, можно использовать выражение «*.txt» для экспорта элементов с расширением TXT.

BadItemLimit

Дополнительно

System.Int32

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

ContentKeywords

Дополнительно

System.String[]

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

DeleteContent

Дополнительно

System.Management.Automation.SwitchParameter

Параметр DeleteContent позволяет удалить содержимое из исходного почтового ящика после его экспорта в папку. Исходная папка не удаляется.

EndDate

Дополнительно

System.DateTime

Параметр EndDate задает конечную дату для фильтрации содержимого, которое экспортируется из исходного почтового ящика. Экспортируются только те элементы в почтовом ящике, дата которых предшествует или равна конечной дате. При вводе конкретной даты используйте краткий формат даты, определенный настроенными на локальном компьютере параметрами Язык и региональные стандарты. Например, если компьютер настроен на использование краткого формата даты мм/дд/гггг, чтобы указать 1 марта 2006 г., введите 03/01/2006.

ExcludeFolders

Дополнительно

Microsoft.Exchange.Data.Mapi.MapiFolderPath[]

Параметр ExcludeFolders позволяет указать список папок, которые следует исключить из экспорта.

GlobalCatalog

Дополнительно

Microsoft.Exchange.Data.Fqdn

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

IncludeFolders

Дополнительно

Microsoft.Exchange.Data.Mapi.MapiFolderPath[]

Параметр IncludeFolders задает список папок, которые следует включить в экспорт.

Locale

Дополнительно

System.Globalization.CultureInfo

Параметр Locale задает язык экспортируемых сообщений. Команда экспортирует только сообщения с указанными языковыми стандартами.

MaxThreads

Дополнительно

System.Int32

С помощью параметра MaxThreads можно указать максимальное количество используемых потоков.

ReportFile

Дополнительно

Microsoft.Exchange.Data.LocalLongFullPath

Параметр ReportFile используется для указания пути и имени файла журнала отчетов в формате XML.

StartDate

Дополнительно

System.DateTime

Параметр StartDate используется для указания начальной даты для фильтрации содержимого, которое экспортируется из исходного почтового ящика. Экспортируются только те элементы в почтовом ящике, дата которых позднее начальной даты. При вводе конкретной даты используйте краткий формат даты, определенный настроенными на локальном компьютере параметрами Язык и региональные стандарты. Например, если компьютер настроен на использование краткого формата даты мм/дд/гггг, чтобы указать 1 марта 2006 г., введите 03/01/2006.

SubjectKeywords

Дополнительно

System.String[]

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

ValidateOnly

Дополнительно

System.Management.Automation.SwitchParameter

Параметр ValidateOnly заставляет команду имитировать действия, которые она будет выполнять над объектом. Используя параметр ValidateOnly, администратор может просматривать изменения, которые произойдут при выполнении команды, без применения всех этих изменений.

noteПримечание.
При выполнении команды Export-Mailbox с этим параметром никакие фильтры к сообщениям не применяются. Команда лишь проверяет, существуют ли исходный и целевой почтовые ящики.

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

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

Ошибки

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

 

Исключения

Исключения Описание

 

Пример

В первом примере показано, как экспортировать содержимое почтового ящика пользователя «john@contoso.com» в папку «MyData» почтового ящика «ExportMailbox».

Во втором примере показано использование фильтров для задания в исходном почтовом ящике элементов, которые будут экспортироваться. В этом примере экспортируются из почтового ящика пользователя «contoso\john» все элементы, которые имеют ключевое слово «merger» (слияние) в тексте сообщения или вложении, имеют вложение с именем «*orgchart*» и дату позднее 12:01:00, 03/01/2006.

В третьем примере продемонстрирован поиск и удаление элементов из почтового ящика. В этом примере сначала находятся все почтовые ящики в базе данных DB1 и выполняется поиск элементов, содержащих в теме строку «Virus message». Элементы экспортируются в другой почтовый ящик и удаляются из исходного почтового ящика.

В четвертом примере демонстрируется возможность передачи результатов команды Get-User команде Export-Mailbox. Также в этом примере из экспорта исключаются две папки. Элементы в папках «Нежелательная почта» и «Контакты» в почтовом ящике Джона (John) не экспортируются в почтовый ящик ExportMailbox.

noteПримечание.
Также можно передать результаты выполнения команды Get-Recipient или Get-Mailbox команде Export-Mailbox.
Export-Mailbox -Identity john@contoso.com -TargetMailbox ExportMailbox -TargetFolder MyData
Export-Mailbox -Identity contoso\john -TargetMailbox ExportMailbox -TargetFolder MyData -ContentKeywords "merger" -AttachmentFilenames "*orgchart*" -StartDate "03/01/2006 12:01:00"
Get-Mailbox -Database DB1 | Export-Mailbox -TargetMailbox ExportMailbox -TargetFolder VirusData -SubjectKeywords "Virus message" -DeleteContent
Get-User john | Export-Mailbox -TargetMailbox ExportMailbox -TargetFolder MyData -ExcludeFolders "\Junk E-Mail","\Contacts"