Use the Move-IMAPMailboxToExchange cmdlet to add data from IMAP files into Microsoft Exchange Server 2007 mailboxes.

Move-IMAPMailboxToExchange -TransporterObject <Microsoft.Exchange.Transporter.IAlienDataObject> [-EmailStart <DateTime>] [-SourceAdminCredential <PSCredential>] [-MaxThreadCount <UInt32>] [-TargetMapping <String>] [-TargetClientAccessServer <String>] [-FolderMapFile <String>] [-EmailEnd <DateTime>] [-TargetIdentity <String>] [-GlobalCatalog <String>] [-AllowUnsecureConnection] [-Quiet] [-TargetCredential <PSCredential>]

Move-IMAPMailboxToExchange [-SourcePassword <String>] [-SourcePort <UInt32>] -SourceLoginID <String> -SourceServer <String> -SourceIdentity <String> [-SourceRootFolder <String>] [-EmailStart <DateTime>] [-SourceAdminCredential <PSCredential>] [-MaxThreadCount <UInt32>] [-TargetMapping <String>] [-TargetClientAccessServer <String>] [-FolderMapFile <String>] [-EmailEnd <DateTime>] [-TargetIdentity <String>] [-GlobalCatalog <String>] [-AllowUnsecureConnection] [-Quiet] [-TargetCredential <PSCredential>]

Parameters

Parameter Required Type Description

SourceIdentity

Required

System.String

A unique SMTP e-mail address that is used to identify the mailbox that is being moved and to match it with an existing Exchange mailbox.

SourceLoginID

Required

System.String

A text string that is used as the IMAP user logon ID of an individual source IMAP mailbox.

SourceServer

Required

System.String

The IMAP server that contains the mailbox content that you want to move.

TransporterObject

Required

Microsoft.Exchange.Transporter.IAlienDataObject

Used to pass in Transporter objects from the Get-ImapMailboxData task through the Windows PowerShell pipeline.

AllowUnsecureConnection

Optional

System.Management.Automation.SwitchParameter

Allows the task to connect to the source server over a non-Secure Sockets Layer (SSL) port to move content from an IMAP mailbox.

EmailEnd

Optional

System.DateTime

Used to specify the end date in a date range to filter mailbox content based on date.

EmailStart

Optional

System.DateTime

Used to specify the start date in a date range to filter mailbox content based on date.

FolderMapFile

Optional

System.String

The file that contains the IMAP folder mapping. Used to create a custom mapping of IMAP folders to Exchange folders.

GlobalCatalog

Optional

System.String

The fully qualified domain name (FQDN) of the global catalog to be used to retrieve mailbox information from the Active Directory directory service.

MaxThreadCount

Optional

System.UInt32

The maximum number of threads that are allocated to importing mail into Exchange.

Quiet

Optional

System.Management.Automation.SwitchParameter

Suppresses feedback during task actions.

SourceAdminCredential

Optional

System.Management.Automation.PSCredential

The PowerShell credential object that contains a user name and password.

SourcePassword

Optional

System.String

A text string that is used as the password to log on to an individual source IMAP mailbox.

SourcePort

Optional

System.UInt32

The port that is used to connect to the source IMAP server.

SourceRootFolder

Optional

System.String

Used to indicate the root of an IMAP mailbox.

TargetClientAccessServer

Optional

System.String

The name of the target Client Access server.

TargetCredential

Optional

System.Management.Automation.PSCredential

The PowerShell credential object that contains a user name and password.

TargetIdentity

Optional

System.String

The SMTP address that is used to indicate a specific target Exchange mailbox for the content. If this parameter is not set, the SourceIdentity parameter is used to find a matching target mailbox.

TargetMapping

Optional

System.String

Not used.

UseDelegate

Optional

System.Management.Automation.SwitchParameter

Allows the user to bypass an attempt to use Exchange Impersonation rights to access a mailbox in Exchange Server. To use this parameter, you must have Full Access permissions for the target mailbox.

Detailed Description

The Move-IMAPMailboxToExchange cmdlet extracts content from IMAP mailboxes and copies that content into existing Exchange mailboxes. The cmdlet binds to the source IMAP mailboxes by using mailbox information that is passed through the command parameters or through a Transporter object that is created by using the Get-IMAPMailboxData cmdlet.

Folder structure, e-mail, MIME information, and attachments are preserved during the move process.

To copy IMAP mailbox content to Exchange mailboxes by using the Move-IMAPMailboxToExchange cmdlet, you must have Recipient Administrator permissions on the computer that is running Exchange 2007 or Full Access permissions on the target mailboxes. To extract mailbox data from an IMAP server, you must have either individual credentials for each source mailbox or Administrator credentials that can be used to access all IMAP mailboxes on the source server.

Input Types

None.

Return Types

None.

Example

The following example shows you how to move a single mailbox by using Administrator credentials. In this example, Administrator credentials are stored as a credential object called $credential. To create a credential object, use the Get-Credential cmdlet.

The following example shows you how to move a single mailbox by using a unique user logon ID and password.

See Also