Import-Mailbox

  • 项目

 

适用于： Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

上一次修改主题： 2011-06-21

使用 Import-Mailbox cmdlet 可以将邮箱数据从 .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>]]

详细说明

若要运行 Import-Mailbox cmdlet，必须为您使用的帐户委派下列角色：

  • Exchange Server 管理员角色和目标服务器的本地 Administrators 组

  • 对目标邮箱的完全访问权限

有关权限、角色委派以及管理 Microsoft Exchange Server 2007 所需权限的详细信息，请参阅权限注意事项。

要授予对某个邮箱的完全访问权限，请使用 Add-MailboxPermission cmdlet，并对 AccessRights 参数指定 FullAccess。

若要从 .pst 文件导入数据，必须在安装了以下各项的 32 位计算机上运行 Import-Mailbox cmdlet：

  • 32 位版本的 Exchange 管理工具

  • Microsoft Office Outlook 2003 Service Pack 2 (SP2) 或更高版本

有关 32 位版本的 Exchange 2007 管理工具的下载信息，请参阅 Microsoft Exchange Server 2007 Management Tools (32-Bit)（英文网页）。

可以使用 Import-Mailbox cmdlet 将数据导入到文件夹或 .pst 文件。源邮箱和目标邮箱所在的计算机必须运行下列 Exchange 版本之一：

  • Exchange Server 2007

  • Exchange Server 2003 Service Pack 2 (SP2) 或更高版本

  • Exchange 2000 Server Service Pack 3 (SP3) 或更高版本

要将数据从 .pst 文件导入到任何其他 Exchange 版本上的邮箱，则必须使用 Microsoft Exchange Server Mailbox Merge Wizard (ExMerge.exe)（英文网页）。

无法使用 Import-Mailbox cmdlet 将数据从 .pst 文件导入到恢复存储组 (RSG) 上的邮箱。

无法使用 Import-Mailbox cmdlet 将数据导入到公用文件夹数据库。

note注意：
使用 Import-Mailbox cmdlet 时，无需配置 MAPI 配置文件。

参数

参数 必需 类型 说明

PSTFolderPath

必需

Microsoft.Exchange.Data.LongPath

PSTFolderPath 参数指定从中导入数据的 .pst 文件的路径。

AllContentKeywords

可选

System.String[]

AllContentKeywords 参数指定导入中要包含的内容的关键字。如果该命令在邮件正文、附件内容或主题中找到指定的关键字，则将导入这些邮件。

note注意：
使用此参数与同时使用 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 文件中的项目才会被导入。输入特定的日期时，请使用在本地计算机上配置的“区域选项”设置中定义的短日期格式。例如，如果将计算机配置为使用短日期格式 mm/dd/yyyy，则指定 2006 年 3 月 1 日时请输入 03/01/2006。

ExcludeFolders

可选

Microsoft.Exchange.Data.Mapi.MapiFolderPath[]

ExcludeFolders 参数指定在导入期间要排除的文件夹的列表。

GlobalCatalog

可选

Microsoft.Exchange.Data.Fqdn

GlobalCatalog 参数指定用于搜索目标邮箱的全局编录。

Identity

可选

Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter

Identity 参数指定要将数据导入到的目标邮箱对象。可以使用下列值之一：

  • ADObjectID

  • 可分辨名称 (DN)

  • 旧版 Exchange DN

  • GUID

  • 域\帐户名

  • 用户主体名称 (UPN)

  • 电子邮件地址

  • 别名

如果通过管道传输 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 文件中的项目才会被导入。输入特定的日期时，请使用在本地计算机上配置的“区域选项”设置中定义的短日期格式。例如，如果将计算机配置为使用短日期格式 mm/dd/yyyy，则指定 2006 年 3 月 1 日时请输入 03/01/2006。

SubjectKeywords

可选

System.String[]

SubjectKeywords 参数指定 .pst 文件中的项目主题的关键字筛选器。

ValidateOnly

可选

System.Management.Automation.SwitchParameter

ValidateOnly 参数可以在不导入数据的情况下验证导入。ValidateOnly 参数验证该命令的所有先决条件。

note注意：
如果运行包含此参数的 Import-Mailbox 命令，该命令将不会对邮件应用任何筛选器。该命令将只检查源邮箱和目标邮箱是否存在。

WhatIf

可选

System.Management.Automation.SwitchParameter

WhatIf 参数指示命令模拟对对象执行的操作。通过使用 WhatIf 参数，可以查看要发生的更改，而不必应用任何这些更改。不必为 WhatIf 参数指定值。

输入类型

返回类型

错误

错误 说明

 

示例

第一个示例说明如何将数据从文件 C:\PSTFiles\john.pst 导入到已连接的现有邮箱 john@contoso.com。

第二个示例说明如何将数据从 C:\PSTFiles 目录下的所有 .pst 文件导入到现有邮箱。必须将 .pst 文件命名为 <alias> .pst，其中alias是要将数据导入到的邮箱的别名。对于每个 .pst 文件，只有在 2007 年 1 月 1 日后收到的邮件才会被导入到该邮箱。

第三个示例说明如何将数据从 .pst 文件导入到其用户属于 Marketing 组织单位的邮箱。必须将 .pst 文件命名为 <alias> .pst，其中alias是要将数据导入到的邮箱的别名。只有其别名与 Marketing 组织单位中的用户相对应的 .pst 文件才会被导入到该邮箱。如果 C:\PSTFiles 中不存在与 Marketing 组织单位中的用户相对应的 .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