Chat now with support
Chat with Support

Recovery Manager for Exchange 5.8.1 - User Guide

Getting started Working with storages
About storages Extracting an Exchange Server database from backup
Working with Quest® Rapid Recovery® (AppAssure®) Working with Quest® NetVault Backup® Working with Quest® vRanger® Working with CA ARCserve Backup Working with EMC NetWorker Working with HP Data Protector Working with IBM Tivoli Storage Manager Working with Microsoft Data Protection Manager Working with Microsoft Windows Backup Working with Microsoft Windows Server Backup Working with Symantec Backup Exec Working with Symantec NetBackup Working with unlisted backup software
Accessing backups directly Extracting incremental or differential backups Registering a storage Opening a storage Closing a storage Renaming a storage Deleting a storage Deleting items from a target storage Deleting items from a source storage Setting access permissions for target files
Restoring data
Optimizing Recovery Manager for Exchange performance Storage indexing Restoring messages Restoring attachments Restoring folders Restoring mailboxes Importing Data from .Pst Files to Online Exchange Mailboxes Selecting a target folder Comparing and restoring storages, mailboxes, or folders Searching for messages, attachments, or folders in source storages
Automated Tasks Management Shell Web Interface Appendices
Mailbox Restore Wizard Public Folder Restore Wizard Message Restore Wizard Message Delete Wizard Import .Pst Files Wizard Add Storage Wizard Catalog Wizard Task Wizard
Select Action Select Template Specify Task File Option: Catalog Backups Template Option: Restore Templates
Comparison of Recovery Manager for Exchange editions

Cmdlets for managing automated tasks

Management Shell > Cmdlets provided by Management Shell > Cmdlets for managing automated tasks

The Management Shell provides cmdlets that allow you to retrieve automated task objects and start and stop automated tasks. The names of such cmdlets have the format <Verb>-RMETask.

Table 37: Cmdlets for managing automated tasks

Cmdlet Description
Get-RMETask Retrieves automated tasks.
Run-RMETask Runs automated tasks.
Stop-RMETask Stops running automated tasks.

Here are some examples of how to use these cmlets:

Table 38: Examples: Running, stopping, or getting automated tasks

Command Description

Get-RMETask | Where { $ -match ".pst" } | Run-RMETask


The Get-RMETask cmdlet gets all existing automated tasks whose name includes the string ".pst", and then pipes them to the Run-RMETask cmdlet which runs these tasks.

Stop-RMETask -ID 2c040513-803d-4098- 9930-9467373ee499


Stops the running automated task with the specified ID.

Get-RMETask | Where { $ -match ".pst" } | Stop-RMETask


The Get-RMETask cmdlet gets all existing automated tasks whose name includes the string ".pst", and then pipes them to the Run-RMETask cmdlet which stops the running tasks.

Other cmdlets

The table below provides descriptions of all other cmdlets supplied with the Management Shell.

Table 39: Other cmdlets

Cmdlet Description
Catalog-RMEBackup Catalogs backups and writes information about cataloged backups to the Recovery Manager for Exchange backup catalog.
Delete-RMEMessage Deletes the messages you specify.
Extract-RMEExchangeDB Extracts Exchange Server database files from the backups you specify.
Import-RMEPersonalFolders Imports messages from the Personal Folders (.pst) files you specify to online mailboxes on Exchange Servers.

Here are some examples of how to use these cmdlets:

Table 40: Examples of using other cmdlets

Command Description

Catalog-RMEBackup -MediaType Files - MediaNames \\intranet.corp\Backups\ ExchangeBackup_02072013.bkf


This command catalogs the backup file named ExchangeBackup-02072013.bkf and located on the network share \\intranet.corp\Backup.

Get-RMEExchangeServer -TargetDomain "dom.europe.corp" | Get-RMEMailbox - MailboxNameInclude "Doe" | Get-RMEMessage -SearchIn Subject -Text "Contract" | Delete-RMEMessage

The Get-RMEExchangeServer cmdlet gets all Exchange Server objects located in the dom.europe.corp domain.

These objects are then piped to the Get-RMEMailbox cmdlet that retrieves the mailbox whose name includes the word Doe.

The mailbox object is then passed to the Get- RMEMessage cmdlet that retrieves the message whose subject includes the word Contract.

Finally, the Delete-RMEMessage cmdlet deletes the retrieved message.

Extract-RMEExchangeDB -MediaType Files - MediaNames "C:\Exchange\BKF\FullExchangeBackup.bkf" -ExtractPath "C:\Exchange\Extracted Databases" | Attach-RMEExchangeDB | Get- RMEMailbox | Restore-RMEMailbox - TargetPath "C:\Data\Exported\Pst"


The Extract-RMEExchangeDB cmdlet extracts the Exchange Server database from the FullExchangeBackup.bkf file to the Extracted Databases folder.

The Attach-RMEExchangeDB cmdlet then connects to the extracted database and pipes it to the Get- RMEMailbox cmdlet, which gets all mailboxes from the database.

The mailbox objects are then piped to the Restore- RMEMailbox cmdlet, which restores each mailbox to an individual Personal Folders (.pst) file in the

C:\Data\Exported\Pst folder.

Import-RMEPersonalFolders -Items C:\PSTFiles -TargetDomain - NameMatchType Equals -TargetType OnPremise -ImportLocation Root


This command imports messages from all Personal Folders (.pst) files found in the root of the C:\PSTFiles folder.

The messages are imported to the on-premises Exchange Server mailboxes hosted in the Active Directory domain named The domain is accessed in the security context of the user account under which the Management Shell is running.

The messages are imported from each source .pst file into the root of the target online mailbox whose alias, display name, or sAMAccountName value is identical to the .pst file name or file owner's name.

Usage scenarios

Management Shell > Usage scenarios

This section covers the following scenarios:

Restoring online mailboxes to individual .pst files

Management Shell > Usage scenarios > Restoring online mailboxes to individual .pst files

The following example demonstrates how to restore online Exchange Server mailboxes to individual .pst files:

Table 41: Scenario: Restoring online mailboxes to individual .pst files

Command Description

Get-RMEExchangeServer | Get-RMEMailbox | Restore-RMEMailbox -TargetPath "C:\Exported\PST"

The Get-RMEExchangeServer cmdlet enumerates all Exchange Servers in the current Active Directory domain, and then pipes the server objects to the Get- RMEMailbox cmdlet, which retrieves all all the mailboxes from those servers.

The Restore-RMEMailbox cmdlet then restores each of the mailboxes to an individual .pst file in the C:\Exported\PST folder.

Related Documents