Move-DominoMailbox

Use the Move-DominoMailbox cmdlet to associate Domino users with existing Active Directory directory service mailbox-enabled accounts and then migrate the users' Domino mail database(s) to Microsoft Exchange Server 2007 mailboxes.

Note:
Exchange impersonation must be enabled in order to migrate user's mail databases. For more information about impersonation, see Exchange Impersonation.


Move-DominoMailbox -TargetMailboxDatabase <String> [-Confirm <SwitchParameter>] [-DomainController <String>] [-EmailEnd <DateTime>] [-EmailStart <DateTime>] [-ExcludeEmail <SwitchParameter>] [-ExcludeSchedule <SwitchParameter>] [-ExcludeTask <SwitchParameter>] [-MailboxObject <IAlienDataObject>] [-MaxThreadCount <UInt32>] [-Quiet <SwitchParameter>] [-TargetCredential <PSCredential>] [-TargetIdentity <String>] [-TargetMapping <String>] [-TargetMode <String>] [-WhatIf <SwitchParameter>]

Move-DominoMailbox -TargetMailboxDatabase <String> [-Confirm <SwitchParameter>] [-DomainController <String>] [-EmailEnd <DateTime>] [-EmailStart <DateTime>] [-ExcludeEmail <SwitchParameter>] [-ExcludeSchedule <SwitchParameter>] [-ExcludeTask <SwitchParameter>] [-MailboxObject <IAlienDataObject>] [-MaxThreadCount <UInt32>] [-Quiet <SwitchParameter>] [-TargetCredential <PSCredential>] [-TargetIdentity <String>] [-TargetMapping <String>] [-TargetMode <String>] [-WhatIf <SwitchParameter>]


Move-DominoMailbox -SourceIdentity <String> -TargetMailboxDatabase <String> [-Confirm <SwitchParameter>] [-DomainController <String>] [-DominoDirectoryDatabase <String>] [-DominoDirectoryServer <String>] [-EmailEnd <DateTime>] [-EmailStart <DateTime>] [-ExcludeEmail <SwitchParameter>] [-ExcludeSchedule <SwitchParameter>] [-ExcludeTask <SwitchParameter>] [-MaxThreadCount <UInt32>] [-NotesIniPath <String>] [-Quiet <SwitchParameter>] [-SourceCredential <PSCredential>] [-SourceMapping <String>] [-TargetCredential <PSCredential>] [-TargetIdentity <String>] [-TargetMapping <String>] [-TargetMode <String>] [-WhatIf <SwitchParameter>]

Move-DominoMailbox -SourceIdentity <String> -TargetMailboxDatabase <String> [-Confirm <SwitchParameter>] [-DomainController <String>] [-DominoDirectoryDatabase <String>] [-DominoDirectoryServer <String>] [-EmailEnd <DateTime>] [-EmailStart <DateTime>] [-ExcludeEmail <SwitchParameter>] [-ExcludeSchedule <SwitchParameter>] [-ExcludeTask <SwitchParameter>] [-MaxThreadCount <UInt32>] [-NotesIniPath <String>] [-Quiet <SwitchParameter>] [-SourceCredential <PSCredential>] [-SourceMapping <String>] [-TargetCredential <PSCredential>] [-TargetIdentity <String>] [-TargetMapping <String>] [-TargetMode <String>] [-WhatIf <SwitchParameter>]


Move-DominoMailbox -ToPipeline <SwitchParameter> [-Confirm <SwitchParameter>] [-DomainController <String>] [-DominoDirectoryDatabase <String>] [-DominoDirectoryServer <String>] [-EmailEnd <DateTime>] [-EmailStart <DateTime>] [-ExcludeEmail <SwitchParameter>] [-ExcludeSchedule <SwitchParameter>] [-ExcludeTask <SwitchParameter>] [-MaxThreadCount <UInt32>] [-NotesIniPath <String>] [-Quiet <SwitchParameter>] [-SourceCredential <PSCredential>] [-SourceMapping <String>] [-TargetIdentity <String>] [-WhatIf <SwitchParameter>]

Move-DominoMailbox -ToPipeline <SwitchParameter> [-Confirm <SwitchParameter>] [-DomainController <String>] [-DominoDirectoryDatabase <String>] [-DominoDirectoryServer <String>] [-EmailEnd <DateTime>] [-EmailStart <DateTime>] [-ExcludeEmail <SwitchParameter>] [-ExcludeSchedule <SwitchParameter>] [-ExcludeTask <SwitchParameter>] [-MaxThreadCount <UInt32>] [-NotesIniPath <String>] [-Quiet <SwitchParameter>] [-SourceCredential <PSCredential>] [-SourceMapping <String>] [-TargetIdentity <String>] [-WhatIf <SwitchParameter>]

Parameters

Parameter	Required	Type	Description
SourceIdentity	Required	System.String	Unique name for the Domino Mailbox. GUID, user's hierarchical name, user's canonical name, or user's SMTP address
TargetMailboxDatabase	Required	System.String	Exchange 2007 mailbox database name
ToPipeline	Required	System.Management.Automation.SwitchParameter	Extracts information from Domino Directory and displays it on the screen
DominoDirectoryDatabase	Optional	System.String	Domino Directory file name (Typically names.nsf)
DominoDirectoryServer	Optional	System.String	Domino server hosting Directory that will be used for this process.
EmailEnd	Optional	System.DateTime	End date for mail to be migrated.
EmailStart	Optional	System.DateTime	Start date for mail to be migrated.
ExcludeEmail	Optional	System.Management.Automation.SwitchParameter	Do not migrate e-mail items
ExcludeSchedule	Optional	System.Management.Automation.SwitchParameter	Do not migrate calendar items.
ExcludeTask	Optional	System.Management.Automation.SwitchParameter	Do not migrate to-do items.
MailboxObject	Optional	Microsoft.Exchange.Transporter.IAlienDataObject	Pipeline object.
MaxThreadCount	Optional	System.UInt32	Maximum number of threads allocated to this task.
NotesIniPath	Optional	System.String	Path to local Notes.ini file including the filename.
SourceCredential	Optional	System.Management.Automation.PSCredential	PSH credential object consisting of Notes ID file and password.
TargetCredential	Optional	System.Management.Automation.PSCredential	Imports information into Active Directory using a different username.
TargetIdentity	Optional	System.String	Active Directory account associated with this user.
TargetMode	Optional	System.String	The TargetMode parameter specifies the mode of injection. “Purge” clears the target of any records before beginning the injection, “Merge” checks each item to see if it exists prior to writing it to the target, and “Append” copies all records to the target location.
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. The default value is $true.
DomainController	Optional	System.String	The DomainController parameter specifies the fully qualified domain name (FQDN) of the domain controller that retrieves data from Active Directory directory service.
SourceMapping	Optional	System.String	The SourceMapping parameter specifies a custom mapfile that defines how the attributes in the object schema will be mapped from the source schema.
TargetMapping	Optional	System.String	The TargetMapping parameter specifies a custom mapfile that defines how the attributes in the source object will be mapped to the target schema.
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. The default value is $true.

Detailed Description

The Move-DominoMailbox cmdlet associates the Domino mail database owner's SMTP proxy address with an existing Active Directory account, mailbox-enables the account if necessary, and then extracts mail, calendar, and task items from the Domino mail database and writes those items to an Exchange 2007 mailbox.

To run the Move-DominoMailbox cmdlet, you must have the Web services impersonation on the Exchange 2007 server where the mailbox is created or updated. The Notes ID file on the local workstation must have Reader or higher access control list (ACL) access to the Domino Directory and the Domino mail database.

For related information, see Mail Migration Prerequisites.

Example

The following code example uses variables to select two users' mail databases that are then migrated.

	Copy Code
$mailboxes = Get-DominoMailbox $movers = "TUser0", "TUser1" foreach ($m in $mailboxes) { if ($movers -contains $m.alias) { Move-DominoMailbox -TargetMailboxDatabase "Mailbox Database" -MailboxObject $m } }

Copy Code

$mailboxes = Get-DominoMailbox
$movers = "TUser0", "TUser1"
foreach ($m in $mailboxes) 
{
  if ($movers -contains $m.alias) 
  {
	Move-DominoMailbox -TargetMailboxDatabase "Mailbox Database" -MailboxObject $m
  }
}