How To: Rehydrate Enterprise Vault Shortcuts

Detailed Description

This How To will provide steps on how a Microsoft Exchange Mailbox or Online Archive containing Veritas Enterprise Vault shortcuts can be rehydrated using the Simply Migrate Management Shell.

Creating the job

Enterprise Vault Shortcut rehydration is a wonderfully simple task. An Example command is shown here;

New-SmJob -Source Exchange -SourceInput user@domain.com -RehydrationSource EnterpriseVault -SourceOptions UseStream,Ex2016 -SourceEwsUrl (Get-SmDefaultO365EwsUrl) -SourceCredential (Get-Credential) -BatchId 1 -Tags "EV Rehydration"

Let’s have a look at the parameters used and explain them;

Source – You can tab through this list to see all supported Technologies that you can export data FROM, we chose Exchange
SourceInput – This is the mailbox you want to migrate the data from.
SourceOptions – We have specified UseStream for support of all message classes and full fidelity message transfer.
SourceEwsUrl – The Exchangre Web Services URL for the mailbox we are Rehydrating Shortcuts in. In this case we are working with an Office 365 account.
RehydrationSource – Here we have specified that we wish to Rehydrate Enterprise Vault Shortcuts found in our source mailbox.
BatchId – This tells the job to which batch it belongs.
Tags – You can give your jobs nice tags so they are easier to group in the Management User Interface.

But I have thousands of Users?! What do I do?

It’s in situations like this that being a PowerShell driven product shines best.  Scalability and simplicity;

$users = Get-Content C:\data\myusers.txt
$creds = Get-Credential

foreach ($user in $users)
{
  New-SmJob -Source Exchange -SourceInput $($user) -RehydrationSource EnterpriseVault -SourceOptions UseStream -SourceCredential $creds -BatchId 1
}

The above script doesn’t do anything magic.  What we are seeing is a text file called myusers.txt that contains a list of email addresses of users we wish to rehydrate shortcuts for. Now, we have shown this with a text file of email addresses, but this could just as easily be an Active directory group that we query and grab email addresses from, or a CSV file, or an OU.  The options are limitless.

The $creds variable is then populated from the Get-Credential prompt.
We then iterate through all the users and create jobs to rehydrate the mailboxes and free them from Shortcuts.
As the jobs are created, they will be added to the Batch and start processing as soon as the Batch has an available slot.

How about items in the users Archive mailbox?

The above cmdlets show you how to rehydrate Enterprise Vault shortcuts in the users mailbox.  There are many scenarios where users have shortcuts in the Online Archive mailbox as well, so it is worthy of demonstration to show how simple it is to create jobs for this use case.

In essense, the scripts are the same as the above with one minor difference.  the addition of UseArchive in the SourceOptions.
The below example shows the job being created for a list of users contained in a text file.

$users = Get-Content C:\data\myusers.txt
$creds = Get-Credential

foreach ($user in $users)
{
  New-SmJob -Source Exchange -SourceInput $($user) -RehydrationSource EnterpriseVault -SourceOptions UseArchive,UseStream -SourceCredential $creds -BatchId 1
}