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

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

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

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

Синтаксис

New-MailboxImportRequest -Mailbox <MailboxOrMailUserIdParameter> -FilePath <LongPath> [-AcceptLargeDataLoss <SwitchParameter>] [-AssociatedMessagesCopyOption <DoNotCopy | MapByMessageClass | Copy>] [-BadItemLimit <Unlimited>] [-BatchName <String>] [-Confirm [<SwitchParameter>]] [-ConflictResolutionOption <KeepSourceItem | KeepLatestItem | KeepAll>] [-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\ToImport.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-MailboxImportRequest.

Confirm

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

System.Management.Automation.SwitchParameter

ConflictResolutionOption

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

Microsoft.Exchange.MailboxReplicationService.ConflictResolutionOption

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

  • KeepSourceItem

  • KeepLatestItem

  • KeepAll

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

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\#.

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

Если параметр TargetRootFolder не указан при импорте папки «Элементы для восстановления», то элементы для восстановления помещаются в папку «Элементы для восстановления» целевого почтового ящика или архива.

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 указывает, что PST-файл импортируется в архив пользователя.

MRSServer

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

Microsoft.Exchange.Data.Fqdn

Name

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

System.String

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

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

SourceRootFolder

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

System.String

Параметр SourceRootFolder указывает корневую папку PST-файла, из которого импортируются данные. При указании параметра иерархия папок вне той, что задана параметром SourceRootFolder, не импортируется, и параметр SourceRootFolder сопоставляется с параметром TargetRootFolder . Если этот параметр не задан, команда импортирует все папки.

Suspend

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

System.Management.Automation.SwitchParameter

SuspendComment

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

System.String

TargetRootFolder

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

System.String

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

WhatIf

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

System.Management.Automation.SwitchParameter

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

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

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

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

Ошибки

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

 

Примеры

ПРИМЕР 1

В этом примере на сервере SERVER01 восстановленный PST-файл импортируется в основной почтовый ящик пользователя «Ayla». Импортируются только данные из папки «Входящие» PST-файла. Данные импортируются в папку «RecoveredFiles» целевого почтового ящика пользователя «Ayla».

Скопировать код 
New-MailboxImportRequest -Mailbox Ayla -FilePath \\SERVER01\PSTFiles\Recovered.pst -TargetRootFolder "RecoveredFiles" -IncludeFolders "#Inbox#"

ПРИМЕР 2

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

Скопировать код 
New-MailboxImportRequest -Mailbox Kweku -IsArchive -FilePath \\SERVER01\PSTFiles\Archives\Kweku\Archive2007.pst

ПРИМЕР 3

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

Скопировать код 
Dir \\SERVER01\PSTshareRO\Recovered\*.pst | %{ New-MailboxImportRequest -Name RecoveredPST -BatchName Recovered -Mailbox $_.BaseName -FilePath $_.FullName -TargetRootFolder SubFolderInPrimary}