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

Синтаксис

import-Mailbox [-Identity <MailboxIdParameter>] -PSTFolderPath <LongPath> [-AllContentKeywords <String[]>] [-AllowDuplicates <SwitchParameter>] [-AttachmentFilenames <String[]>] [-BadItemLimit <Int32>] [-Confirm [<SwitchParameter>]] [-ContentKeywords <String[]>] [-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>]]

Параметры

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

PSTFolderPath

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

Microsoft.Exchange.Data.LongPath

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

AllContentKeywords

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

System.String[]

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

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

AllowDuplicates

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

System.Management.Automation.SwitchParameter

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

AttachmentFilenames

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

System.String[]

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

BadItemLimit

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

System.Int32

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

Confirm

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

System.Management.Automation.SwitchParameter

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

ContentKeywords

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

System.String[]

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

EndDate

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

System.DateTime

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

ExcludeFolders

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

Microsoft.Exchange.Data.Mapi.MapiFolderPath[]

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

GlobalCatalog

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

Microsoft.Exchange.Data.Fqdn

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

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

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

Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter

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

  • ADObjectID

  • Различающееся имя (DN)

  • Устаревшее различающееся имя Exchange

  • GUID;

  • Домен\Имя учетной записи

  • Имя участника-пользователя

  • адрес электронной почты

  • псевдоним.

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

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 указывает дату начала для фильтрации содержимого, импортируемого в целевой почтовый ящик. Импортируются только те элементы PST-файла, дата которых позднее даты начала. При вводе конкретной даты следует использовать короткий формат даты, определенный в региональных параметрах локального компьютера. Например, если компьютер настроен на использование краткого формата даты мм/дд/гггг, введите 03/01/2006, чтобы указать дату 1 марта 2006 г.

SubjectKeywords

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

System.String[]

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

ValidateOnly

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

System.Management.Automation.SwitchParameter

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

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

WhatIf

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

System.Management.Automation.SwitchParameter

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

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

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

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

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

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

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

Чтобы импортировать данные из PST-файла, необходимо запустить командлет Import-Mailbox на 32-разрядном компьютере, на котором установлены следующие программы:

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

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

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

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

  • Exchange Server 2007

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

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

Чтобы импортировать данные из PST-файла в почтовый ящик, расположенный на любой другой версии сервера Exchange, необходимо использовать мастер объединения почтовых ящиков Microsoft Exchange Server (ExMerge.exe) (на английском языке).

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

Командлет Import-Mailbox не позволяет импортировать данные в базу данных общих папок.

Примечание.
При использовании командлета Import-Mailbox настраивать профиль MAPI не нужно.

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

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

Ошибки

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

 

Пример

В первом примере показано, как импортировать данные из файла C:\PSTFiles\john.pst в существующий подключенный почтовый ящик john@contoso.com.

Во втором примере показано, как импортировать данные из всех PST-файлов, расположенных в каталоге C:\PSTFiles, в существующие почтовые ящики. Имена PST-файлов должны иметь вид <псевдоним>.pst, где псевдоним — это псевдоним почтового ящика, в который необходимо импортировать данные. Из каждого PST-файла в почтовый ящик будут импортированы только сообщения, полученные после 1 января 2007 г.

В третьем примере показано, как импортировать данные из PST-файлов в почтовые ящики, пользователи которых работают в отделе маркетинга. Имена PST-файлов должны иметь вид <псевдоним>.pst, где псевдоним — это псевдоним почтового ящика, в который необходимо импортировать данные. Будут импортированы только PST-файлы, псевдоним которых соответствует пользователю из отдела маркетинга. В случае отсутствия в папке C:\PSTFiles PST-файлов, соответствующих пользователям из отдела маркетинга будет выведено сообщение об ошибке.

Копировать код 
Import-Mailbox -Identity john@contoso.com -PSTFolderPath C:\PSTFiles\john.pst
Dir C:\PSTFiles | Import-Mailbox -StartDate 01/01/2007
Get-Mailbox -OrganizationalUnit Marketing | Import-Mailbox -PSTFolderPath C:\PSTFiles