Use the Move-POPMailboxToExchange cmdlet to add data from POP3 mailboxes into Microsoft Exchange Server 2007 mailboxes.

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

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

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 POP3 user logon ID of an individual source mailbox.

SourceServer

Required

System.String

The POP3 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-PopMailboxData 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 extract mail from a POP3 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.

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 mailboxes.

Quiet

Optional

System.Management.Automation.SwitchParameter

Suppresses feedback during task actions.

SourceAdminCredential

Optional

System.Management.Automation.PSCredential

The PowerShell credential object that contains the Administrator user name and password for the source POP3 server.

SourcePassword

Optional

System.String

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

SourcePort

Optional

System.UInt32

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

SourceRootFolder

Optional

System.String

Used to indicate the root of a POP3 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 the Administrator user name and password for the target Exchange server.

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 an Exchange mailbox. To use this parameter, you must have Full Access permissions for the target mailbox.

Detailed Description

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

E-mail, MIME information, and attachments are preserved during the move process.

To copy POP3 mailbox content to Exchange mailboxes by using the Move-POPMailboxToExchange cmdlet, you must have Recipient Admin permissions on the computer that is running Exchange 2007 or Full Access permissions to the target mailboxes that are being migrated. To extract mailbox data from a POP3 server, you must have either individual credentials for each source mailbox or Administrator credentials that can be used to access all POP3 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.

  Copy Code 
Move-POPMailboxToExchange –sourceidentity “tom@contoso.com” –sourceloginId “user” –sourceadmincredentials $credentials –sourceserver “contoso.pop.com”

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

  Copy Code 
Move-POPMailboxToExchange –sourceidentity “tom@contoso.com” –sourceloginId “user” –sourcepassword “P@ssw*rd1” –sourceserver “contoso.pop.com”

See Also