Прочитать на английском

Поделиться через


Import-Mailbox

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

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

Командлет 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>] [-IncludeAssociatedMessages <SwitchParameter>] [-IncludeFolders <MapiFolderPath[]>] [-Locale <CultureInfo>] [-MaxThreads <Int32>] [-RecipientKeywords <String[]>] [-SenderKeywords <String[]>] [-StartDate <DateTime>] [-SubjectKeywords <String[]>] [-ValidateOnly <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Параметры

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

PSTFolderPath

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

Microsoft.Exchange.Data.LongPath

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

AllContentKeywords

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

System.String[]

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

Bb629586.note(ru-ru,EXCHG.140).gifПримечание.
Это отличается от использования параметров 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:$False. В синтаксисе необходимо ставить знак двоеточия ( : ).

ContentKeywords

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

System.String[]

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

EndDate

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

System.DateTime

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

ExcludeFolders

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

Microsoft.Exchange.Data.MapiFolderPath[]

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

GlobalCatalog

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

Microsoft.Exchange.Data.Fqdn

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

Identity

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

Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter

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

  • идентификатор объекта Active Directory
  • Различающееся имя (DN)
  • Устаревшее различающееся имя Exchange
  • GUID
  • Домен\Имя учетной записи
  • имя участника-пользователя (UPN)
  • адрес электронной почты
  • Псевдоним

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

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

SubjectKeywords

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

System.String[]

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

ValidateOnly

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

System.Management.Automation.SwitchParameter

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

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

WhatIf

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

System.Management.Automation.SwitchParameter

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

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

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

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

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

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

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

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

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

Ошибки

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

 

Примеры

ПРИМЕР 1

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

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

ПРИМЕР 2

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

Dir C:\PSTFiles | Import-Mailbox -StartDate 01/01/2010

ПРИМЕР 3

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

Get-Mailbox -OrganizationalUnit Marketing | Import-Mailbox -PSTFolderPath C:\PSTFiles