Mimecast Simply Migrate: Migrating On Premises Exchange Mailbox Data

Document created by user.oxriBaJeN4 Employee on Aug 12, 2019
Version 1Show Document
  • View in full screen mode

This page provides steps how the content of an On Premises Microsoft Exchange mailbox can be migrated to Mimecast using the Simply Migrate Management Shell.

To ensure permissions have been correctly set, follow the steps outlined in the Microsoft Office 365 and Microsoft Exchange Permissions page.

Creating a Job


Creating a job to migrate On Premise Exchange mailbox data to Mimecast, the following cmdlet syntax is used:

PS C:\Program Files\Simply Migrate> New-SMJob -Source Exchange -SourceInput user@SourceDomain.com -SourceOptions Ex2010sp2 -SourceEwsUrl 'https://mail.domain.com/EWS/Exchange.asmx' -SourceCredential $SrcCreds -Target Mimecast -TargetOutput user@TargetDomain.com -BatchId 1 -Tags "Mailbox Moves"




BatchIdThe BatchId of the Batch controller that will process this job.
TagsWe have specified a tag to give a friendly name to the job being created.
TargetCredentialThe credential used to connect to the target user.
TargetEwsUrlWe have used a Simply Migrate helper to get the Office 365 EWS URL. If your'e deployment isn't Office 365, specify a customer URL (e.g. https://mail.domain.com/EWS/Exchange.asmx).
TargetOptionsWe have used UseStream and specified the Microsoft Exchange version to avoid relying on Autodiscover. Instead we specify an EWS URL.
TargetOutputThe UPN of the user that we wish to migrate the data to.
TargetWe have chosen Exchange for the target technology.
SourceOptionsWe have used UseStream and Ex2010sp2 as the source mailbox on a Microsoft Exchange Server 2010 Service Pack 2.
This is required for support of all message classes, but will soon be deprecated and assumed for all sources of data targeting Exchange.
SourceInputThe UPN of the user mailbox we are migrating from.
SourceThe source of the data we will be migrating. We have chosen Exchange in this example.
SourceEwsUrlThe Exchange Web Services URL for the Source mailbox.
SourceCredentialThe credentials used for Application Impersonation rights to the source mailbox.


Migrating Multiple Mailboxes


If you've multiple mailboxes to migrate, there are multiple methods of doing this. What follows is a simple approach using a CSV file with following information enclosed:

  1. Create a CSV that lists the users to be migrated. For example:
  2. Create the following script:
    # get the content of the CSV (Your header columns are as per the above example of SourceMailbox $users = Import-Csv -Path c:\temp\users.csv #Grab the source and taarget credentials. $SourceCredentials = Get-Credential -UserName sourcecreds@sourcedomain.com foreach ($user in $users) { New-SMJob -Source Exchange -SourceInput $($user.SourceMailbox) -SourceOptions Ex2010sp2 -SourceEwsUrl 'https://mail.domain.com/EWS/Exchange.asmx' -SourceCredential $SourceCredentials -Target Mimecast -TargetOutput $($user.SourceMailbox) -BatchId 1 -Tags "Mailbox Moves" }
  3. Run the above script which prompts you for the source credentials and creates the jobs. You’re ready to start processing.


See Also...


  • Get-SMBatch
  • New-SMBatch
  • Get-SMConfig
  • Set-SMConfig