Use the Move-DominoUser cmdlet to update Active Directory directory service accounts to mail-enabled accounts or to create new mail-enabled accounts if necessary. You can also use this cmdlet to create Microsoft Exchange Server 2007 mailboxes.

Move-DominoUser -InitialPassword <String> -TargetOU <String> [-Confirm <SwitchParameter>] [-DirectoryObject <IAlienDataObject>] [-DomainController <String>] [-MaxThreadCount <UInt32>] [-Quiet <SwitchParameter>] [-ResetPasswordOnNextLogon <SwitchParameter>] [-TargetCredential <PSCredential>] [-TargetIdentity <String>] [-TargetMailboxDatabase <String>] [-TargetMapping <String>] [-TargetMode <String>] [-WhatIf <SwitchParameter>]

Move-DominoUser -SourceIdentity <String> -InitialPassword <String> -TargetOU <String> [-Confirm <SwitchParameter>] [-CreateMailbox <SwitchParameter>] [-DomainController <String>] [-DominoDirectoryDatabase <String>] [-DominoDirectoryServer <String>] [-MaxThreadCount <UInt32>] [-NotesIniPath <String>] [-Quiet <SwitchParameter>] [-ResetPasswordOnNextLogon <SwitchParameter>] [-SourceCredential <PSCredential>] [-SourceMapping <String>] [-TargetCredential <PSCredential>] [-TargetIdentity <String>] [-TargetMailboxDatabase <String>] [-TargetMapping <String>] [-TargetMode <String>] [-WhatIf <SwitchParameter>]

Move-DominoUser -ToPipeline <SwitchParameter> [-Confirm <SwitchParameter>] [-DomainController <String>] [-DominoDirectoryDatabase <String>] [-DominoDirectoryServer <String>] [-MaxThreadCount <UInt32>] [-NotesIniPath <String>] [-Quiet <SwitchParameter>] [-ResetPasswordOnNextLogon <SwitchParameter>] [-SourceCredential <PSCredential>] [-SourceMapping <String>] [-TargetIdentity <String>] [-WhatIf <SwitchParameter>]

Parameters

Parameter Required Type Description

InitialPassword

Required

System.String

The InitialPassword parameter SSpecifies the initial password to set for new Active Directory accounts. Valid settings: Random creates Windows accounts and generate random passwords.  

SourceIdentity

Required

System.String

The SourceIdentity parameter Sspecifiesy a specific Domino application whose information should be retrieved.

List path and filename relative to the Domino data directory.

For example, \Sales\CustInfo.nsf.

TargetOU

Required

System.String

The TargetOU parameter Ospecifies the organizational unit (OU) container where new Active Directory accounts are created.

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.

DirectoryObject

Optional

Microsoft.Exchange.Transporter.IAlienDataObject

The DirectoryObject parameter Aaccepts an object from the pipeline.

DomainController

Optional

System.String

The DomainController parameter specifies the fully qualified domain name (FQDN) of the domain controller that retrieves data from Active Directory.

DominoDirectoryDatabase

Optional

System.String

The DomainDirectoryDatabase parameter specifies the Domino Directory file name (typically, names.nsf).

DominoDirectoryServer

Optional

System.String

The DominoDirectoryServer specifies the Lotus Domino server hosting Directory that is used for this process.

MaxThreadCount

Optional

System.UInt32

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

NotesIniPath

Optional

System.String

The NotesIniPath parameter specifies the path to the local Notes.INI file including filename.

Quiet

Optional

System.Management.Automation.SwitchParameter

The Quiet parameter suppresses feedback during task actions.

ResetPasswordOnNextLogon

Optional

System.Management.Automation.SwitchParameter

The ResetPasswordOnNextLogin parameter prompts users to change the Active Directory account password at the next logon.

SourceMapping

Optional

System.String

Not supported.

TargetCredential

Optional

System.Management.Automation.PSCredential

The TragetCredential parameter Iimports information into Active Directory using a different username.

TargetIdentity

Optional

System.String

The TargetIdentity parameter specifies the Active Directory account for migrating the information to Active Directory.

TargetMailboxDatabase

Optional

System.String

The TargetMailboxDatabaspecifies that target Exchange 2007 mailbox database.

TargetMapping

Optional

System.String

Not supported.

TargetMode

Optional

System.String

Not supported.

ToPipeline

Optional

System.Management.Automation.SwitchParameter

The ToPipeLine parameter outputs objects to the PowerShell pipeline instead of into Active Directory.

WhatIf

Optional

System.Management.Automation.SwitchParameter

The WhatIf parameter iinstructs 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-DominoUser cmdlet matches the Notes SMTP proxy from the Domino Directory with existing Active Directory accounts. If an exact match is found, the existing account is mail-enabled. If no match is found, a new mail-enabled account is created. This cmdlet can also create Exchange 2007 mailboxes.

Note:
If the target account already exists, it must have the UserPrincipalName attribute set to successfully run this cmdlet.

To run the Move-DominoUser cmdlet, the account you use must be delegated the following:

  • Exchange Recipient Administrator role

  • Account Operator role for applicable Active Directory containers

For related information, see User Migration Prerequisites.

Input Types

MigrationUserItem.

Return Types

None.

Example

The following code example creates a new mail e-named account for Kim Akers in the "users" organizational unit (OU) with the password "pa55w0rd".

  Copy Code 
Move-DominoUser -sourceidentity "Kim Akers/Contoso" -targetOU users -intialpassword "pa55w0rd"