Use the Get-PopMailboxData cmdlet to create a Transporter object from a POP3 mailbox or a group of POP3 mailboxes.

Get-PopMailboxData [-SourceRootFolder <String>] [-SourceLoginID <String>] [-SourcePassword <String>] [-SourceServer <String>] -SourceIdentity <String> [-SourcePort <UInt32>] [-EmailEnd <DateTime>] [-TargetIdentity <String>] [-Quiet] [-EmailStart <DateTime>]  [-SourceAdminCredential <PSCredential>] [-AllowUnsecureConnection]

Get-PopMailboxData -TransporterObject <Microsoft.Exchange.Transporter.IAlienDataObject> [-EmailEnd <DateTime>] [-TargetIdentity <String>] [-Quiet] [-EmailStart <DateTime>]  [-SourceAdminCredential <PSCredential>] [-AllowUnsecureConnection]

Parameters

Parameter Required Type Description

SourceRootFolder

Optional

System.String

Used to indicate the root of the source POP3 mailbox.

SourceLoginID

Required

System.String

The logon ID of an individual source POP3 mailbox.

SourcePassword

Required

System.String

The password for the logon ID that is used in the SourceLoginID parameter.

SourceServer

Required

System.String

The POP3 server that hosts the source mailbox.

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.

SourcePort

Optional

System.UInt32

The port number that is used to connect to the source POP3 server. The default port is 995 (SSL/TLS port).

TransporterObject

Required

Microsoft.Exchange.Transporter.IAlienDataObject

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

EmailEnd

Optional

System.DateTime

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

TargetIdentity

Optional

System.String

The SMTP address that is used to indicate a specific Exchange mailbox to inject mailbox content into. If this parameter is not set, the SourceIdentity parameter is used match the mailbox that is being migrated with an existing Exchange mailbox.

Quiet

Optional

System.Management.Automation.SwitchParameter

Suppresses feedback during task actions.

EmailStart

Optional

System.DateTime

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

SourceAdminCredential

Optional

System.Management.Automation.PSCredential

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

AllowUnsecureConnection

Optional

System.Management.Automation.SwitchParameter

Allows the task to connect the source server over a non-Secure Sockets Layer (SSL) port to extract mail from a POP3 mailbox.

Detailed Description

The Get-PopMailboxData cmdlet extracts content from existing POP3 mailboxes into a Transporter object. E-mail, MIME information, and attachments are preserved when the Transporter object is created.

To create a Transporter object by using the Get-PopMailboxData cmdlet, you must have Full Access permissions to the POP3 mailboxes that you are trying to access. To retrieve mailbox data from a POP3 server, you can use either individual credentials for each mailbox that you want to retrieve, or Administrator credentials to access all mailboxes. For more information, see Source Server Permissions.

Input Types

None.

Return Types

Transporter Object

Example

The following example shows you how to use the Get-PopMailboxData cmdlet to retrieve a single mailbox by using a unique logon ID and password.

The following example shows you how to save a Transporter object that was created by using the Get-PopMailboxData cmdlet as a pipeline object and move it to a computer that is running Microsoft Exchange Server 2007 by using the Add-ExchangeItem cmdlet.

  Copy Code 
Get-PopMailboxData -SourceIdentity tom@contoso.com -SourceServer "MAILSERVER-1" -SourceLoginID "tom" -SourcePassword "P@ssW0rd1" | Add-ExchangeItem

Comments

See Also