The following table describes the parameter set for the script.

Parameter set of the Prepare-MoveRequest.ps1 script

Parameter	Required	Description
Identity	Required	The Identity parameter uniquely identifies a mailbox in the source forest. Identity can be any of the following: Common name (CN) Alias proxyAddress property objectGuid property DisplayName property
RemoteForestCredential	Required	The RemoteForestCredential parameter specifies the administrator who has permissions to copy data from the source forest Active Directory.
RemoteForestDomainController	Required	The RemoteForestDomainController parameter specifies a domain controller in the source forest where the mailbox resides.
DisableEmailAddressPolicy	Optional	The DisableEmailAddressPolicy parameter specifies whether the Email Address Policy (EAP) should be disabled when creating a MailUser object in the target forest. When you specify this parameter, the EAP in the target forest won't be applied. Note: When you specify this parameter, the MailUser object won't have e-mail address mapping in the local forest domain stamped. This is usually stamped by the EAP.
LinkedMailUser	Optional	The LinkedMailUser switch specifies whether to create a linked MailUser in the local forest for the mailbox user in the remote forest. If the switch is provided, the script creates a target MailUser object linked to the source mailbox. If the switch is omitted, the script creates a regular target MailUser object.
LocalForestCredential	Optional	The LocalForestCredential parameter specifies the administrator with permissions to write data to the target forest Active Directory. We recommend that you explicitly specify this parameter to avoid Active Directory permission issues. If the remote forest and the local forest have a trusted relationship configured, don't use a user account from the remote forest as the local forest credential, even though the remote user account may have permission to modify Active Directory in the local forest.
LocalForestDomainController	Optional	The LocalForestDomainController parameter specifies a domain controller in the target forest where the mail-enabled user will be created. We recommend that you specify this parameter to avoid possible domain controller replication delay issues in the local forest that could occur if a random domain controller is selected.
MailboxDeliveryDomain	Optional	The MailboxDeliveryDomain parameter specifies an authoritative domain of the source forest so that the script can select the correct source mailbox user's proxyAddress property as the target mail-enabled user's targetAddress property. By default, the primary SMTP address of the source mailbox user is set as the targetAddress property of the target mail-enabled user.
OverWriteLocalObject	Optional	The OverWriteLocalObject parameter is used for users created by the Active Directory Migration Tool. The properties are copied from the existing mail contact to the newly created mail user. However, after this copy, the script also copies the properties from the source forest user to the newly created mail user.
TargetMailUserOU	Optional	The TargetMailuserOU parameter specifies the organizational unit (OU) under which the target mail-enabled user will be created.
UseLocalObject	Optional	The UseLocalObject parameter specifies whether to convert the existing local object to the required target mail-enabled user if the script detects an object in the local forest that conflicts with the to-be-created mail-enabled user.

This example provisions a single linked mail-enabled user in the local forest, when there is forest trust between the remote forest and local forest.

1. Run the following commands to get the local forest and remote forest credentials.
   
   

   	Copy Code
   $LocalCredentials = Get-Credential $RemoteCredentials = Get-Credential

2. Run the following command to pass the credential information to the LocalForestCredential and RemoteForestCredential parameters in the Prepare-MoveRequest.ps1 script.
   
   

   	Copy Code
   Prepare-MoveRequest.ps1 -Identity JamesAlvord@Contoso.com -RemoteForestDomainController DC001.Fabrikam.com -RemoteForestCredential $RemoteCredentials -LocalForestDomainController DC001.Contoso.com -LocalForestCredential $LocalCredentials -LinkedMailUser

This example supports pipelining if you supply a list of mailbox identities.

1. Run the following command.
   
   

   	Copy Code
   $UserCredentials = Get-Credential

2. Run the following command to pass the credential information to the RemoteForestCredential parameter in the Prepare-MoveRequest.ps1 script.
   
   

   	Copy Code
   "IanP@Contoso.com", "JoeAn@Contoso.com" | Prepare-MoveRequest.ps1 -RemoteForestDomainController DC001.Fabrikam.com -RemoteForestCredential $UserCredentials

You can generate a .csv file containing a list of mailbox identities from the source forest, which allows you to pipe the content of this file into the script to bulk-create the target mail-enabled users.

For example, the content of the .csv file can be:

Identity

Ian@contoso.com

John@contoso.com

Cindy@contoso.com

This example calls a .csv file to bulk create the target mail-enabled users.

1. Run the following command to get the remote forest credentials.
   
   

   	Copy Code
   $UserCredentials = Get-Credential

2. Run the following command to pass the credential information to the RemoteForestCredential parameter in the Prepare-MoveRequest.ps1 script.
   
   

   	Copy Code
   Import-Csv Test.csv | Prepare-MoveRequest.ps1 -RemoteForestDomainController DC001.Fabrikam.com -RemoteForestCredential $UserCredentials

When the script attempts to create a target mail-enabled user from the source mailbox user, and it detects a duplicate local mail-enabled object, it uses the following logic:

• If the source mailbox user's masterAccountSid attribute equals any target object's objectSid or masterAccountSid attribute:
  
  
  • If the target object isn't mail-enabled, the script returns an error because the script doesn't support converting an object that isn't mail-enabled to a mail-enabled user.
    
    
  • If the target object is mail-enabled, the target object is a duplicate.
    
    
• If an address in the source mailbox user's proxyAddress properties (smtp/x500 only) equals an address in a target object's proxyAddress properties (smtp/x500 only), the target object is a duplicate.
  
  

The script prompts the user about the duplicate objects.

If the target mail-enabled object is a mail-enabled user or contact, which is most likely created by a cross-forest (Identity Lifecycle Management 2007 Service Pack 1-based) global address list (GAL) synchronization deployment, the user can run the script again with the UseLocalObject parameter to use the target mail-enabled object for mailbox migration.

If the target object is a mail-enabled user, the script copies the following attributes from the source mailbox user to the target mail-enabled user:

• msExchMailboxGUID
  
  
• msExchArchiveGUID
  
  
• msExchArchiveName
  
  

If the LinkedMailUser parameter is set, the script copies the source objectSid/masterAccountSid attribute.

If the target object is a mail-enabled contact, the script deletes the existing contact and copies all its attributes to a new mail-enabled user. The script also copies the following attributes from the source mailbox user:

• msExchMailboxGUID
  
  
• msExchArchiveGUID
  
  
• msExchArchiveName
  
  
• sAMAccountName
  
  
• userAccountControl (set to 514 //equivalent to 0x202, ACCOUNTDISABLE | NORMAL_ACCOUNT)
  
  
• userPrincipalName
  
  

If the LinkedMailUser parameter is set, the script copies the source objectSid/masterAccountSid attribute.

When the Update-Recipient cmdlet is called to convert the target object into a mail-enabled user, a new LegacyExchangeDN attribute is generated for the target mail-enabled user. The script copies the LegacyExchangeDN attribute of the target mail-enabled user as an x500 address to the proxyAddress properties of the source mailbox user. This action ensures the correct resolution of recipients when messages are sent between the source and target forests.