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 используется для указания ключевых слов для содержимого, которое необходимо импортировать. При обнаружении заданного ключевого слова в тексте сообщения, вложении или поле «Тема» команда импортирует соответствующие сообщения. ![]()
Это отличается от использования параметров 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 можно использовать для отключения запросов на подтверждение, которые отображаются по умолчанию при запуске командлета. Чтобы отключить запросы на подтверждение, используйте синтаксис |
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 указывает объект целевого почтового ящика, в который требуется импортировать данные. Можно использовать одно из следующих значений:
Если объект команды 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, не будет выполнено никаких изменений. ![]()
При выполнении команды 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 не позволяет импортировать данные в базу данных общих папок.
Для запуска этого командлета необходимы соответствующие разрешения. В этом разделе перечислены все параметры командлета, однако некоторые из них могут быть недоступны, если они не включены в назначенные разрешения. Сведения о необходимых разрешениях см. в Запись «Импорт и экспорт почтового ящика» в разделе Разрешения для почтового ящика.
Ошибка | Описание |
---|---|
|
В этом примере импортируются данные из файла "C:\PSTFiles\yuri.pst" в существующий подключенный почтовый ящик yuri@contoso.com.
Import-Mailbox -Identity john@contoso.com -PSTFolderPath C:\PSTFiles\john.pst
Во этом примере импортируются данные из всех файлов PST, расположенных в каталоге "C:\PSTFiles", в существующие почтовые ящики. Имена PST-файлов должны иметь вид <псевдоним>.pst, где псевдоним — это псевдоним почтового ящика, в который импортируются данные. Из каждого файла PST в почтовый ящик будут импортированы только сообщения, полученные после 01.01.2010.
Dir C:\PSTFiles | Import-Mailbox -StartDate 01/01/2010
В этом примере импортируются данные из файлов PST в почтовые ящики, пользователи которых находятся в подразделении «Маркетинг». Имена PST-файлов должны иметь вид <псевдоним>.pst, где псевдоним — это псевдоним почтового ящика, в который импортируются данные. Будут импортированы только те файлы PST, псевдоним которых соответствует пользователю подразделения «Маркетинг». В случае отсутствия в папке "C:\PSTFiles" файлов PST, соответствующих пользователям подразделения «Маркетинг», будет выдано сообщение об ошибке.
Get-Mailbox -OrganizationalUnit Marketing | Import-Mailbox -PSTFolderPath C:\PSTFiles