Export-Mailbox

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

Последнее изменение раздела: 2009-07-07

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

Синтаксис

export-Mailbox -Identity <MailboxIdParameter> [-AllContentKeywords <String[]>] [-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[]>] [-SenderKeywords <String[]>] [-StartDate <DateTime>] [-SubjectKeywords <String[]>] [-ValidateOnly <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

export-Mailbox -Identity <MailboxIdParameter> -TargetFolder <String> -TargetMailbox <MailboxIdParameter> [-AllContentKeywords <String[]>] [-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[]>] [-SenderKeywords <String[]>] [-StartDate <DateTime>] [-SubjectKeywords <String[]>] [-ValidateOnly <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

export-Mailbox -Identity <MailboxIdParameter> -PSTFolderPath <LongPath> [-AllContentKeywords <String[]>] [-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[]>] [-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. Эта папка содержит вложенную папку «Восстановленные данные» — <псевдоним исходного почтового ящика><отметка даты и времени>. В этой вложенной папке содержатся экспортированные данные. Если указанная целевая папка уже существует в целевом почтовом ящике, экспортируемые данные будут добавлены в нее. Если целевой папки не существует, она создается.

TargetMailbox

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

Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter

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

AllContentKeywords

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

System.String[]

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

Aa998579.note(ru-ru,EXCHG.140).gifПримечание.
Это отличается от использования параметров ContentKeywords и SubjectKeywords. При одновременном использовании параметров ContentKeywords и SubjectKeywords команда экспортирует только те сообщения, которые содержат как ключевое слово, указанное для параметра ContentKeywords в тексте сообщения или содержимом вложения, так и ключевое слово, указанное для параметра SubjectKeywords в поле «Тема».

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 марта 2010 г., необходимо ввести 01.03.2010.

ExcludeFolders

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

Microsoft.Exchange.Data.MapiFolderPath[]

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

GlobalCatalog

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

Microsoft.Exchange.Data.Fqdn

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

IncludeAssociatedMessages

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

System.Management.Automation.SwitchParameter

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

IncludeFolders

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

Microsoft.Exchange.Data.MapiFolderPath[]

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

Locale

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

System.Globalization.CultureInfo

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

MaxThreads

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

System.Int32

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

RecipientKeywords

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

System.String[]

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

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

SenderKeywords

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

System.String[]

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

StartDate

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

System.DateTime

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

SubjectKeywords

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

System.String[]

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

ValidateOnly

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

System.Management.Automation.SwitchParameter

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

Aa998579.note(ru-ru,EXCHG.140).gifПримечание.
При выполнении команды Export-Mailbox с этим параметром никакие фильтры к сообщениям не применяются. Команда позволяет только определить, существуют ли исходный и целевой почтовые ящики.

WhatIf

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

System.Management.Automation.SwitchParameter

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

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

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

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

Чтобы экспортировать данные из файла PST, необходимо запустить командлет Export-Mailbox на сервере Exchange с 64-разрядной версией Microsoft Outlook 2010. Эту команду рекомендуется выполнять на выделенном сервере Exchange, на котором отсутствуют почтовые ящики.

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

  • Входящие
  • Удаленные
  • Черновики
  • Нежелательная почта
  • Исходящие
  • Отправленные
  • Журнал
  • Календарь
  • Контакты
  • Примечания
  • Задачи
Aa998579.note(ru-ru,EXCHG.140).gifПримечание.
В системе Exchange 2010 данные из корзины не экспортируются.
Aa998579.note(ru-ru,EXCHG.140).gifПримечание.
Если заданы параметры ключевых слов, командлет Export-Mailbox сначала экспортирует все сообщения, а затем ищет в целевом почтовом ящике сообщения с указанным ключевым словом. Сообщения из корзины исходного почтового ящика преобразуются в целевом почтовом ящике в обычные и будут также проверены на ключевые слова. После этого командлет Export-Mailbox удаляет из целевого почтового ящика сообщения, не содержащие ключевых слов. При наличии параметра DeleteContent командлет Export-Mailbox удаляет из исходного почтового ящика сообщения, содержащие ключевое слово.

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

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

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

Ошибки

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

 

Исключения

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

 

Примеры

ПРИМЕР 1

В этом примере показано, как экспортировать содержимое почтового ящика пользователя yuri@contoso.com в папку «Мои_данные» почтового ящика «Почтовый_ящик_для_экспорта».

Export-Mailbox -Identity john@contoso.com -TargetMailbox ExportMailbox -TargetFolder MyData

ПРИМЕР 2

В этом примере показано использование фильтров для задания в исходном почтовом ящике элементов, которые будут экспортироваться. В этом примере из почтового ящика пользователя contoso\yuri экспортируются все элементы, которые имеют ключевое слово «слияние» в тексте сообщения или вложении, в именах вложений которых содержится слово «диаграмма», а их дата позднее 01.03.2010, 12:01:00.

Export-Mailbox -Identity contoso\john -TargetMailbox ExportMailbox -TargetFolder MyData -ContentKeywords "merger" -AttachmentFilenames "*orgchart*" -StartDate "03/01/2010 12:01:00"

ПРИМЕР 3

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

Get-Mailbox -Database DB1 | Export-Mailbox -TargetMailbox ExportMailbox -TargetFolder VirusData -SubjectKeywords "Virus message" -DeleteContent

ПРИМЕР 4

В этом примере выходные данные команды Get-User передаются конвейерным образом команде Export-Mailbox. Также в этом примере из экспорта исключаются две папки. Элементы в папках «Нежелательная почта» и «Контакты» в почтовом ящике Юрия не экспортируются в целевой почтовый ящик «Почтовый_ящик_для экспорта».

Aa998579.note(ru-ru,EXCHG.140).gifПримечание.
Также можно передать конвейерным образом выходные данные командлета Get-Recipient или Get-Mailbox командлету Export-Mailbox.
Get-User john | Export-Mailbox -TargetMailbox ExportMailbox -TargetFolder MyData -ExcludeFolders "\Junk E-mail","\Contacts"

ПРИМЕР 5

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

Export-Mailbox -Identity john@contoso.com -PSTFolderPath C:\PSTFiles\john.pst

ПРИМЕР 6

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

Get-Mailbox -OrganizationalUnit Marketing | Export-Mailbox -PSTFolderPath C:\PSTFiles -RecipientKeywords "tony@fabrikam.com","christine@fabrikam.com"