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

Синтаксис

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

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

export-Mailbox -Identity <MailboxIdParameter> -PSTFolderPath <LongPath> [-AllContentKeywords <String[]>] [-AllowDuplicates <SwitchParameter>] [-AttachmentFilenames <String[]>] [-BadItemLimit <Int32>] [-Confirm [<SwitchParameter>]] [-ContentKeywords <String[]>] [-DeleteAssociatedMessages <SwitchParameter>] [-DeleteContent <SwitchParameter>] [-EndDate <DateTime>] [-ExcludeFolders <MapiFolderPath[]>] [-GlobalCatalog <Fqdn>] [-IncludeAssociatedMessages <SwitchParameter>] [-IncludeFolders <MapiFolderPath[]>] [-Locale <CultureInfo>] [-MaxThreads <Int32>] [-RecipientKeywords <String[]>] [-ReportFile <LocalLongFullPath>] [-SenderKeywords <String[]>] [-StartDate <DateTime>] [-SubjectKeywords <String[]>] [-ValidateOnly <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Параметры

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

Identity

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

Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter

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

  • псевдоним;

  • SMTP-адрес;

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

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

PSTFolderPath

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

Microsoft.Exchange.Data.LongPath

Параметр PSTFolderPath указывает путь к PST-файлу, в который будут экспортированы данные.

TargetFolder

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

System.String

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

TargetMailbox

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

Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter

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

AllContentKeywords

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

System.String[]

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

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

AllowDuplicates

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

System.Management.Automation.SwitchParameter

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

AllowMerge

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

System.Management.Automation.SwitchParameter

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

AttachmentFilenames

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

System.String[]

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

BadItemLimit

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

System.Int32

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

Confirm

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

System.Management.Automation.SwitchParameter

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

ContentKeywords

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

System.String[]

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

DeleteAssociatedMessages

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

System.Management.Automation.SwitchParameter

Параметр DeleteAssociatedMessages указывает, что сопоставленные сообщения будут удалены. Сопоставленные сообщения содержат скрытые данные о правилах, представлениях и формах.

Если указать параметр DeleteAssociatedMessages и не указать параметры TargetMailbox и TargetFolder или PSTFolderPath, содержимое экспортироваться не будет.

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 задает глобальныо каталог, который необходимо использовать для поиска целевого почтового ящика.

IncludeAssociatedMessages

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

System.Management.Automation.SwitchParameter

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

IncludeFolders

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

Microsoft.Exchange.Data.Mapi.MapiFolderPath[]

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

Locale

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

System.Globalization.CultureInfo

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

MaxThreads

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

System.Int32

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

RecipientKeywords

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

System.String[]

Параметр RecipientKeywords задает адреса электронной почты или краткие имена получателей. Если команда обнаружит сообщение с получателем, указанным в параметре, тогда она экспортирует данное сообщение.

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

ReportFile

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

Microsoft.Exchange.Data.LocalLongFullPath

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

SenderKeywords

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

System.String[]

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

StartDate

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

System.DateTime

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

SubjectKeywords

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

System.String[]

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

ValidateOnly

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

System.Management.Automation.SwitchParameter

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

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

WhatIf

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

System.Management.Automation.SwitchParameter

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

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

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

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

  • Полный доступ к исходным и целевым почтовым ящикам

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

Для предоставления полного доступа к почтовому ящику воспользуйтесь командлетом Add-MailboxPermission и укажите значение FullAccess для параметра AccessRights.

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

Для экспорта данных в папку или PST-файл воспользуйтесь командлетом Export-Mailbox. Исходный и целевой почтовые ящики должны находиться на одном из указанных ниже серверов.

  • Сервер Exchange 2007

  • Сервер Exchange Server 2003 с пакетом обновления 2 (SP2) (или более поздней версии)

  • Сервер Exchange 2000 Server с пакетом обновления 3 (SP3) (или более поздней версии)

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

  • 32-разрядная версия средств управления Exchange.

  • Microsoft Office Outlook 2003 с пакетом обновления 2 (SP2) или более поздняя версия.

Примечание.
В статьях базы знаний Майкрософт 289999 (на английском языке) и 813593 (на английском языке) описана проблема с использованием Outlook 2003 для удаления нескольких объектов из папки. Удалить из папки более 4000 объектов с помощью командлета Export-Mailbox невозможно. Чтобы экспортировать большее число объектов, используйте Outlook 2007.

Дополнительные сведения о загрузке 32-разрядной версии средств управления Exchange 2007 см. на странице средств управления Microsoft Exchange Server 2007 (32-разрядная версия) (на английском языке).

Экспорт данных в PST-файл из почтового ящика, находящегося в группе хранения для восстановления, невозможен.

Экспорт данных из базы данных общих папок невозможен.

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

  • Входящие

  • Удаленные

  • Черновики

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

  • Исходящие

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

  • Дневник

  • Календарь

  • Контакты

  • Заметки

  • Задачи

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

Примечание.
Если заданы ключевые слова, командлет Export-Mailbox сперва экспортирует все сообщения, в том числе и из корзины, а затем отыщет в целевом почтовом ящике сообщения с указанным ключевым словом. Сообщения из корзины исходного почтового ящика преобразуются в целевом почтовом ящике в обычные и будут также проверены на ключевые слова. После этого командлет Export-Mailbox удаляет из целевого почтового ящика сообщения, не содержащие ключевых слов. При использовании параметра DeleteContent командлет Export-Mailbox удаляет из исходного почтового ящика сообщения, содержащие ключевое слово.

При экспорте данных в PST-файл с использованием параметра PSTFolderPath командлет 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.

Примечание.
Также можно передать результаты выполнения команды Get-Recipient или Get-Mailbox команде Export-Mailbox.

Пятый пример показывает, как экспортировать содержимое почтового ящика пользователя john@contoso.com в PST-файл с именем john.pst в каталоге C:\PSTFiles.

Шестой пример показывает, как экспортировать данные из всех почтовых ящиков пользователей подразделения Marketing. Данные из каждого почтового ящика будут экспортированы в отдельный PST-файл в каталоге C:\PSTFiles. Имя каждого PST-файла будет иметь вид <псевдоним>.pst. Будут экспортированы те сообщения, в число получателей которых входят либо tony@fabrikam.com, либо christine@fabrikam.com.

Копировать код 
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"
Export-Mailbox -Identity john@contoso.com -PSTFolderPath C:\PSTFiles\john.pst
Get-Mailbox -OrganizationalUnit Marketing | Export-Mailbox -PSTFolderPath C:\PSTFiles -RecipientKeywords "tony@fabrikam.com","christine@fabrikam.com"