Import Mailbox Data

[This topic is in progress.]

By default, the Import-Mailbox cmdlet imports all empty folders, special folders, and subfolders from a .pst file to the target location. When importing folders, you can include or exclude the following special folders:

• Inbox
• Deleted Items
• Drafts
• Junk E-mail
• Outbox
• Sent Items
• Journal
• Calendar
• Contacts
• Notes
• Tasks

From each of these folders, the Import-Mailbox cmdlet imports the following messages:

• All folder messages if they exist in the .pst file. Messages contain hidden data with information about rules, views, and forms.
• All messages from the transport dumpster if they exist in the .pst file.
• All message types, including messages, calendar items, contacts, distribution lists, journal entries, tasks, notes, and documents.

Looking for other management tasks related to importing or exporting mailbox data? Check out Managing Mailbox Import and Export.

Prerequisites

• To import mailbox data, you must run the Import-Mailbox cmdlet against a 64-bit computer that has the following installed:
  • Microsoft Exchange Server 2010 role
  • 64-bit Microsoft Outlook 2010
• You must have the correct permissions to import or export mailbox data. By default, none of the preloaded role groups contain the Mailbox Import Export role. Therefore, you must add the Mailbox Import Export role to a role group. For more information, see Add the Mailbox Import Export Role to a Role Group.
• The mailbox to which you're importing the data must exist. You can't import data to a user account that doesn't have a mailbox.

Use the Shell to import mailbox data

You need to be assigned permissions before you can perform this procedure. To see what permissions you need, see the "Import\Export mailbox" entry in the Mailbox Permissions topic.

This example imports data from the john.pst file to the mailbox belonging to john@contoso.com.

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

This example imports all the mailbox data from the john.pst file received between January 1, 2009, and April 1, 2009.

Import-Mailbox -Identity john@contoso.com -PSTFolderPath C:\PSTFiles\john.pst -StartDate 01/01/2009 -EndDate 04/01/2009

This example imports mailbox data from all the .pst files located in C:\PSTFiles into the corresponding mailboxes. The .pst files in C:\PSTFiles must each be named <alias>.pst.

Dir C:\PSTFiles\*.pst | Import-Mailbox -StartDate 01/01/2006 -EndDate 04/01/2006

This example imports mailbox data from .pst files located at C:\PSTFiles into all the mailboxes whose user accounts are in the organizational unit Students.

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

This example imports all the mailbox data from the john.pst file for which christine@fabrikam.com is the sender.

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

This example imports only the mailbox data from the john.pst file in the Sent Items folder.

Import-Mailbox -Identity john -PSTFolderPath C:\PSTFiles\john.pst -IncludeFolders '\Sent Items'

This example excludes the Junk E-mail and Contacts folders from the import,

Import-Mailbox -Identity john -PSTFolderPath C:\PSTFiles\john.pst ExcludeFolders "\Junk E-mail","\Contacts"

By using the filters, this example imports all items from the john.pst file that meet the following criteria:

• Contain the keyword merger in the message body or in the content of an attachment.
• Have an attachment named orgchart.
• Are dated later than March 1, 2006, at 00:01 (12:01 A.M.).
• Have tony@fabrikam.com as one of the recipients.

Import-Mailbox -Identity contoso\john -PSTFolderPath C:\PSTFiles\john.pst -ContentKeywords "merger" -AttachmentFilenames "*orgchart*" -StartDate "03/01/2006 12:01:00" -RecipientKeywords tony@fabrikam.com

For detailed syntax and parameter information, see Import-Mailbox.