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

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

Командлет New-MailboxExportRequest используется для начала процесса экспорта данных из почтового ящика или архива в PST-файл. Существует возможность создать несколько запросов на экспорт для одного почтового ящика; у всех таких запросов должны быть уникальные имена. Microsoft Exchange может автоматически создать до 10 уникальных имен запроса на экспорт почтового ящика. При этом для создания свыше 10 запросов на экспорт для почтового ящика при их создании потребуется указывать уникальные имена. Можно удалить существующие запросы на экспорт с помощью командлета Remove-MailboxExportRequest перед запуском нового запроса с именем по умолчанию: <псевдоним>\MailboxExportX (где X = 0–9).

Синтаксис

New-MailboxExportRequest -Mailbox <MailboxOrMailUserIdParameter> -FilePath <LongPath> [-AcceptLargeDataLoss <SwitchParameter>] [-AssociatedMessagesCopyOption <DoNotCopy | MapByMessageClass | Copy>] [-BadItemLimit <Unlimited>] [-BatchName <String>] [-Confirm [<SwitchParameter>]] [-ConflictResolutionOption <KeepSourceItem | KeepLatestItem | KeepAll>] [-ContentFilter <String>] [-ContentFilterLanguage <CultureInfo>] [-DomainController <Fqdn>] [-ExcludeDumpster <SwitchParameter>] [-ExcludeFolders <String[]>] [-IncludeFolders <String[]>] [-IsArchive <SwitchParameter>] [-MRSServer <Fqdn>] [-Name <String>] [-SourceRootFolder <String>] [-Suspend <SwitchParameter>] [-SuspendComment <String>] [-TargetRootFolder <String>] [-WhatIf [<SwitchParameter>]]

Параметры

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

FilePath

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

Microsoft.Exchange.Data.LongPath

Параметр FilePath указывает путь к сетевой общей папке с PST-файлом, куда экспортируются данные, например \\SERVER01\PST Files\exported.pst.

Mailbox

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

Microsoft.Exchange.Configuration.Tasks.MailboxOrMailUserIdParameter

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

  • Псевдоним.

  • SMTP-адрес.

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

AcceptLargeDataLoss

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

System.Management.Automation.SwitchParameter

AssociatedMessagesCopyOption

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

Microsoft.Exchange.MailboxReplicationService.FAICopyOption

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

  • DoNotCopy   Сопоставленные сообщения не копируются. Это значение используется по умолчанию.

  • MapByMessageClass   В этом варианте необходимое сопоставленное сообщение ищется по атрибуту MessageClass исходного сообщения. Если сопоставленные сообщения этого класса есть и в исходной, и в целевой папках, то сопоставленное сообщение в целевой папке будет перезаписано. Если в целевой папке нет сопоставленного сообщения, то в ней создается копия исходного сообщения.

  • Copy   В этом варианте сопоставленные сообщения копируются из исходной папки в целевую. Если сообщения одного типа есть и в исходной, и в целевой папках, то они дублируются.

Примечание.
Фильтрация содержимого не применяется к сопоставленным сообщениям.

BadItemLimit

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

Microsoft.Exchange.Data.Unlimited

Параметр BadItemLimit указывает число пропускаемых неправильных элементов в случае, если запрос обнаруживает в почтовом ящике повреждение. Используйте значение 0, чтобы не пропускать неправильные элементы. Допустимый диапазон вводимых значений для этого параметра: от 0 до 2147483647. По умолчанию значение равно 0. Рекомендуется оставлять значение по умолчанию 0 и изменять значение параметра BadItemLimit только в случае, если запрос на перемещение завершается с ошибкой.

Примечание.
Если задать для параметра BadItemLimit значение, превышающее 50, то команда завершится ошибкой и возникнет следующее предупреждение: «Подтвердите, что вы готовы принять потерю больших объемов данных, указав параметр AcceptLargeDataLoss.». При возникновении этого предупреждения следует запустить команду повторно, использовав параметр AcceptLargeDataLoss. Дополнительные предупреждения не выводятся, и поврежденные элементы будут недоступны после завершения перемещения в конечный почтовый ящик.

BatchName

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

System.String

Параметр BatchName указывает описательное имя для экспорта пакета почтовых ящиков. Это имя затем можно использовать в параметре BatchName в качестве строки поиска при использовании командлета Get-MailboxExportRequest.

Confirm

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

System.Management.Automation.SwitchParameter

ConflictResolutionOption

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

Microsoft.Exchange.MailboxReplicationService.ConflictResolutionOption

Параметр ConflictResolutionOption задает действие службы репликации почтовых ящиков (MRS) Microsoft Exchange в том случае, если в целевом объекте есть несколько совпадающих сообщений. Он может иметь следующие значения:

  • KeepSourceItem

  • KeepLatestItem

  • KeepAll

По умолчанию значение равно KeepSourceItem.

ContentFilter

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

System.String

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

Дополнительные сведения о фильтруемых свойствах см. в разделе Фильтруемые свойства для параметра -ContentFilter.

ContentFilterLanguage

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

System.Globalization.CultureInfo

Параметр ContentFilterLanguage задает язык, используемый в параметре ContentFilter для строкового поиска.

Допустимыми значениями параметра ContentFilterLanguage являются строковые имена, перечисленные в столбце Имя культурной среды в справке по классам библиотеки классов Microsoft .NET, которая находится на веб-странице Класс CultureInfo.

DomainController

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

Microsoft.Exchange.Data.Fqdn

ExcludeDumpster

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

System.Management.Automation.SwitchParameter

Параметр ExcludeDumpster задает исключение папки "Элементы для восстановления". Указывать значение для этого параметра необязательно. Если параметр не указан, папка "Элементы для восстановления" копируется со следующими вложенными папками:

  • Deletions

  • Versions

  • Purges

ExcludeFolders

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

System.String[]

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

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

  • <FolderName>/*   Используйте этот синтаксис для обозначения личной папки в папке, указанной в параметре SourceRootFolder например "MyProjects" или "MyProjects/FY2010".

  • #<FolderName>#/*   Используйте этот синтаксис для обозначения известной папки вне зависимости от имени папки на другом языке. Например, #Inbox# обозначает папку "Входящие" даже в турецкой локализации, где она называется "Gelen Kutusu". Известными папками являются следующие:

    • Inbox (Входящие).

    • SentItems (Отправленные).

    • DeletedItems (Удаленные).

    • Calendar (Календарь).

    • Contacts (Контакты).

    • Drafts (Черновики).

    • Journal (Журнал).

    • Tasks (Задачи).

    • Notes (Заметки).

    • JunkEmail (Нежелательная почта).

    • CommunicationHistory (Журнал обращений).

    • Voicemail (Голосовая почта).

    • Fax (Факс).

    • Conflicts (Конфликты).

    • SyncIssues (Проблемы синхронизации).

    • LocalFailures (Локальные ошибки).

    • ServerFailures (Серверные ошибки).

Если пользователь создает личную папку с именем, совпадающим с именем известной папки, заключая его в символы #, то для указания этой папки можно использовать косую черту (/). Например, если пользователь создает папку #Notes# и требуется указать именно ее, а не известную папку Notes, используйте следующий синтаксис: \#Notes\#.

Примечание.
В именах папок нельзя использовать подстановочные знаки.

IncludeFolders

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

System.String[]

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

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

  • <FolderName>/*   Используйте этот синтаксис для обозначения личной папки в папке, указанной в параметре SourceRootFolder например "MyProjects" или "MyProjects/FY2010".

  • #<FolderName>#/*   Используйте этот синтаксис для обозначения известной папки вне зависимости от имени папки на другом языке. Например, #Inbox# обозначает папку "Входящие" даже в турецкой локализации, где она называется "Gelen Kutusu". Известными папками являются следующие:

    • Inbox (Входящие).

    • SentItems (Отправленные).

    • DeletedItems (Удаленные).

    • Calendar (Календарь).

    • Contacts (Контакты).

    • Drafts (Черновики).

    • Journal (Журнал).

    • Tasks (Задачи).

    • Notes (Заметки).

    • JunkEmail (Нежелательная почта).

    • CommunicationHistory (Журнал обращений).

    • Voicemail (Голосовая почта).

    • Fax (Факс).

    • Conflicts (Конфликты).

    • SyncIssues (Проблемы синхронизации).

    • LocalFailures (Локальные ошибки).

    • ServerFailures (Серверные ошибки).

Если пользователь создает личную папку с именем, совпадающим с именем известной папки, заключая его в символы #, то для указания этой папки можно использовать косую черту (/). Например, если пользователь создает папку #Notes# и требуется указать именно ее, а не известную папку Notes, используйте следующий синтаксис: \#Notes\#.

Примечание.
В именах папок нельзя использовать подстановочные знаки.

IsArchive

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

System.Management.Automation.SwitchParameter

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

MRSServer

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

Microsoft.Exchange.Data.Fqdn

Name

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

System.String

Параметр Name задает имя запроса, используемое для отслеживания и отображения. Поскольку для одного почтового ящика можно завести несколько запросов на экспорт, Exchange предваряет имя псевдонимом почтового ящика. Например, если создается запрос на экспорт почтового ящика пользователя с псевдонимом «Kweku», а для этого параметра указывается значение «PC1toArchive», то полный идентификатор этого запроса на экспорт будет иметь вид «Kweku\PC1toArchive».

Если не указать имя с помощью этого параметра, то Exchange может создать до 10 имен запросов на один почтовый ящик, которые будут иметь вид MailboxExportX (где X = 0–9). Идентификатор запроса отображается и используется при поиске в форме <псевдоним>\MailboxExportX.

SourceRootFolder

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

System.String

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

Suspend

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

System.Management.Automation.SwitchParameter

SuspendComment

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

System.String

TargetRootFolder

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

System.String

Параметр TargetRootFolder указывает папку верхнего уровня, откуда экспортируются данные. Если этот параметр не указан, команда экспортирует папки до самого верха структуры папок в целевом PST-файле. Содержимое существующих папок объединяется, а новые папки добавляются к целевой структуре папок.

WhatIf

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

System.Management.Automation.SwitchParameter

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

Запись «Импорт и экспорт» в разделе Разрешения для почтового ящика.

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

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

Ошибки

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

 

Примеры

ПРИМЕР 1

В этом примере основной почтовый ящик пользователя «Ayla Kol» экспортируется в PST-файл в общей сетевой папке PSTFileShare на сервере SERVER01.

Скопировать код
New-MailboxExportRequest -Mailbox AylaKol -FilePath "\\SERVER01\PSTFileShare\Ayla_Recovered.pst"

ПРИМЕР 2

В этом примере архив пользователя «Kweku» экспортируется в PST-файл в общей сетевой папке PSTFileShare на сервере SERVER01.

Скопировать код
New-MailboxExportRequest -Mailbox Kweku -FilePath "\\SERVER01\PSTFileShare\Kweku_Archive.pst" -IsArchive

ПРИМЕР 3

В этом примере экспортируются сообщения с встречающимися в тексте словами «company» и «profit» и полученные пользователем «Tony» до 1 января 2010 года.

Дополнительные сведения об использовании параметра ContentFilter см. в разделе Фильтруемые свойства для параметра -ContentFilter.

Скопировать код
New-MailboxExportRequest -Mailbox Tony -ContentFilter {(body -like "*company*") -and (body -like "*profit*") -and (Received -lt "01/01/2010")} -FilePath "\\SERVER01\PSTFileShare\Tony_CompanyProfits.pst"

ПРИМЕР 4

В этом примере экспортируются все сообщения из папки «Входящие» пользователя «Kweku» в PST-файл LegalHold.

Скопировать код
New-MailboxExportRequest -Mailbox Kweku -IncludeFolders "#Inbox#" -FilePath \\SERVER01\PSTFileShare\Kweku\LegalHold.pst