Use the Move-NotesMailArchiveToExchange cmdlet to add data from Notes Mail Archive files into Microsoft Exchange Server 2007 mailboxes.

Move-NotesMailArchiveToExchange -SourceFileName <String> -ContentOwner <String> -DominoMailDomain <String> [-Confirm [<SwitchParameter>]] [-EmailEnd <DateTime>] [-EmailStart <DateTime>] [-ExcludeContacts <SwitchParameter>] [-ExcludeEmail <SwitchParameter>] [-ExcludeSchedule <SwitchParameter>] [-ExcludeTask <SwitchParameter>] [-GlobalCatalog <String>] [-MaxThreadCount <UInt32>] [-NotesIniPath <String>] [-Quiet <SwitchParameter>] [-SourceCredential <PSCredential>] [-SourceMapping <String>] [-TargetClientAccessServer <String>] [-TargetCredential <PSCredential>] [-TargetMailboxDatabase <String>] [-TargetMapping <String>] [-TargetMode <String>] [-WhatIf [<SwitchParameter>]]

Parameters

Parameter

Required

Type

Description

ContentOwner

Required

System.String

The ContentOwner parameter specifies the e-mail address of the person to whom this content belongs. This parameter is necessary for any content that you expect to move to an Exchange server and must match the proxy address of an existing AD user. Example: Mike Danseglio/contoso@contoso, MikeD@contoso.com

The default behavior is that the content owner for each item will be specified as <null>.

DominoMailDomain

Required

System.String

This parameter specifies the Domino Mail Domain that should be associated with the extracted mail items.

SourceFileName

Required

System.String

The SourceFileName parameter is the name of the file to be extracted. This should be provided in one of the following formats:

  • Fully qualified path

  • UNC path

  • Relative path to the current directory

Confirm

Optional

System.Management.Automation.SwitchParameter

The Confirm parameter causes the command to pause processing and requires the administrator to acknowledge what the command will do before processing continues.

DomainController

Optional

System.String

The DomainController parameter specifies the target Domain Controller to use for directory operations.

The default behavior is to use DSAccess referrals.

EmailEnd

Optional

System.DateTime

The EmailEnd parameter specifies the end date of the date range that specifies which messages should be included in the migration. Messages without dates are always included.

EmailStart

Optional

System.DateTime

The EmailStart parameter specifies the start date of the date range that specifies which messages should be included in the migration. Messages without dates are always included.

ExcludeContacts

Optional

System.Management.Automation.SwitchParameter

The ExcludeContacts parameter specifies the Contacts information that should be excluded.

ExcludeEmail

Optional

System.Management.Automation.SwitchParameter

The ExcludeEmail parameter specifies which personal e-mail messages to exclude.

ExcludeSchedule

Optional

System.Management.Automation.SwitchParameter

The ExcludeSchedule parameter specifies which schedule messages to exclude.

ExcludeTask

Optional

System.Management.Automation.SwitchParameter

The ExcludeTask parameter specifies which personal task messages to exclude.

GlobalCatalog

Optional

System.String

The GlobalCatalog parameter identifies the Active Directory server.

MaxThreadCount

Optional

System.UInt32

The MaxThreadCount parameter specifies the maximum number of threads allocated to this task.

NotesIniPath

Optional

System.String

The NotesIniPath parameter should be in the form of a full file path to the ini file that the user wants to use to launch the Notes client.

If this parameter is left blank, the notes.ini that is in the install directory is used.

Quiet

Optional

System.Management.Automation.SwitchParameter

The Quiet parameter suppresses feedback during task actions.

SourceCredential

Optional

System.Management.Automation.PSCredential

The SourceCredential parameter specifies the credential to use for authentication to the source platform.

The parameter reads the name of the ID file from the notes.ini and checks whether a PS credential of that name is stored in the engine.

The default behavior is to use the credential of the logged in user running the cmdlet.

SourceMapping

Optional

System.String

The SourceMapping parameter specifies a custom mapfile that defines how the attributes in the object schema are mapped from the source schema.

TargetClientAccessServer

Optional

System.String

The TargetClientAccessServer parameter specifies the Exchange Client Access server.  The server can be specified in either FQDN or URL format.  If specified, this parameter overrides the autodiscovery process and uses only the server specified to access the target technology.

The default behavior is to use autodiscovery.

TargetCredential

Optional

System.Management.Automation.PSCredential

The TargetCredential parameter allows the administrator to specify alternative credentials to connect to the target platform.

TargetMailboxDatabase

Optional

System.String

The TargetMailboxDatabase parameter specifies the Exchange mail database to create new mailboxes in. One of the following "friendly" names: database name; server name\database name; server name\storage group\database name.  If specified, the parameter implies that mailboxes should be created.

By default, a mailbox is not created if one doesn't exist.

TargetMapping

Optional

System.String

The TargetMapping parameter identifies the type of list that will be created:

DocumentLibrary

or

DiscussionDatabase

or

GenericList

TargetMode

Optional

System.String

The TargetMode parameter defines how to handle duplicate data.

Merge does not copy information over if it already exists.

Purge deletes content from the target list and then migrates data.

WhatIf

Optional

System.Management.Automation.SwitchParameter

The WhatIf parameter instructs the command to simulate the actions that it would take on the object. By using the WhatIf parameter, the administrator can view what changes would occur without having to apply any of those changes.

Detailed Description

The Move-NotesMailArchiveToExchange cmdlet adds data from Notes Mail Archive files into Exchange 2007 mailboxes.

To run the Move-NotesMailArchiveToExchange cmdlet, you must have the Web services impersonation on the Exchange server where the mailbox exists. The Notes ID file on the local workstation must have Reader or higher access control list (ACL) access to the specified Archive file.

For related information, see Mail Migration Prerequisites.

Example

The following code will move the Notes mail archive "MyFile.nsf" to the Exchange 2007 mailbox belonging to cowner@domain.com.

  Copy Code
Move-NotesMailArchiveToExchange -SourceFilename MyFile.nsf -ContentOwner cowner@domain.com