How To: Migrate O365 Exchange Mailbox data to Mimecast.

Detailed Description

This How To will provide steps how the content of an Office 365 Microsoft Exchange Mailbox can be migrated to Mimecast using the Simply Migrate Management Shell.
To ensure permissions have been correctly set, please follow the steps outlined in the following article;
Microsoft Office 365 and Microsoft Exchange Permissions

Create Job

To create a job to migrate Office 365 mailbox data to Mimecast, the following cmdlet syntax is used.

New-SMJob -Source Exchange -SourceInput user@SourceDomain.com -SourceOptions Ex2016 -SourceEwsUrl (Get-SmDefaultO365EwsUrl) -SourceCredential $SrcCreds -Target Mimecast -TargetOutput user@TargetDomain.com -BatchId 1 -Tags "Mailbox Moves"

Description of parameters used;

But I have thousands to do ...

Do you know what is cooler than migrating one mailbox? Migrating thousands of mailboxes!
While there are many different ways to achieve this, below, we will show a simple approach using a CSV file with following information enclosed :

SourceMailbox
user@sourcedomain.com
user2@sourcedomain.com

… and so on.
On to a script to process all of the users in that CSV.


# get the content of the CSV (Your header columns are as per the above example of SourceMailbox
$users = Import-Csv -Path c:tempusers.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 Ex2016 -SourceEwsUrl (Get-SmDefaultO365EwsUrl) -SourceCredential $SourceCredentials -Target Mimecast -TargetOutput $($user.SourceMailbox) -BatchId 1 -Tags "Mailbox Moves"
}

Once you run the above script, it will prompt you for the source credentials and create the jobs. You’re ready to start processing.

But it is journal data ...

If the data you are migrating to Mimecast is journal data, there is a minor change to the syntax of the cmdlets shown above.  Quite simply, we aren’t concerned about the folder structure of the messages from a journal.

New-SMJob -Source Exchange -SourceInput user@SourceDomain.com -SourceOptions Ex2016 -SourceEwsUrl (Get-SmDefaultO365EwsUrl) -SourceCredential $SrcCreds -Target Mimecast -BatchId 1 -Tags "Journal Migration"

Note: The difference here is that there is no requirement to use the -TargetOutput parameter in the cmdlet syntax.

The same process as above applies if you have many journal mailboxes, where this could be scripted from a CSV.