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 connecting to storages

Management Shell > Cmdlets provided by Management Shell > Cmdlets for connecting to storages

The Management Shell provides cmdlets that allow you to connect to the items you wish to use as sources or targets for data restore operations. The names of such cmdlets have the format Attach-<Noun>.

Cmdlets for connecting to storages

Cmdlet Description
Attach-RMEArchiveManager Establishes a connection to the specified Archive Manager instance.
Attach-RMEExchangeDB Establishes a connection to the specified Exchange Server database.
Attach-RMEExchangeMailbox Establishes a connection to the live Exchange Server mailbox you specify.
Attach-RMEExchangeOnline Establishes a connection to mailboxes and public folders in Exchange Online (Office 365).
Attach-RMEExchangePublicFolders Establishes a connection to the public folder hierarchy whose Exchange Server you specify.
Attach-RMELotusDB Establishes a connection to the specified Lotus Domino database.
Attach-RMEPersonalFolders Establishes a connection to the Personal Folders (.pst) file you specify.

When connecting to an item which can act as a source or target for data restore operations (for example, a Personal Folders (.pst) file), you need to specify how you want to use that item. To indicate that the item will act as a source, use the -IsSource parameter. In this case, licenses may be allocated to the item as described in License allocation. If the -IsSource parameter is omitted, the item will only act as a target for the data restore operation and no licenses will be allocated to it.

When attaching the Exchange offline database using the Attach-RMEExchangeDB cmdlet, you can add the source or target storage to the list of storages that are registered in Recovery Manager for Exchange console. Provide the -RegisterStorage parameter to register the storage. If the parameter is omitted, the storage will be available only during the PowerShell session and will be disposed after the session is closed.

For more information on what items are supported as source and target storages by your edition of Recovery Manager for Exchange, see Comparison of Recovery Manager for Exchange editions.

Here is an example of how to connect to a Personal Folders (.pst) file:

Table 30: Example: Connecting to a .pst file

Command Description

Attach-RMEPersonalFolders "C:\PST\MyData.pst" -IsSource

This command establishes a connection to the file MyData.pst located in C:\PST. The file will be used as a source storage.

Cmdlets for retrieving (searching for) objects

Management Shell > Cmdlets provided by Management Shell > Cmdlets for retrieving (searching for) objects

The Management Shell provides cmdlets that allow you to retrieve objects representing such items as Exchange Servers, message attachments, folders, mailboxes, or messages. The names of these cmdlets have the format Get-<Noun>.

Table 31: Cmdlets for retrieving objects

Cmdlet Description
Get-RMEAttachment Retrieves attachments from the messages that match the criteria you specify.
Get-RMEExchangeServer Retrieves all Exchange Servers along with the mailboxes they host from a particular Exchange organization.
Get-RMEFolder Retrieves the folders that match the criteria you specify.
Get-RMEMailbox Retrieves the mailboxes that match the criteria you specify.
Get-RMEMessage Retrieves the messages that match the criteria you specify.

To retrieve an object

  1. Connect to the item you wish to use as a storage by using one of the cmdlets described in Cmdlets for connecting to storages.
  2. Pass the output of the cmdlet you used in step 1 to one of the cmdlets that retrieve objects, as shown in the next examples. To pass the output, you can use pipelining or a variable.

Table 32: Examples: Retrieving objects

Command Description

Attach-RMEExchangeDB C:\Demo\priv1.edb | Get-RMEMailbox "Administrator" | Get- RMEFolder "Inbox" | Get-RMEMessage -Text "confidential" -SearchIn Subject

The Attach-RMEExchangeDB cmdlet connects to the offline Exchange Server database priv1.edb, and then pipes the database object to the Get-RMEMailbox cmdlet.

The Get-RMEMailbox cmdlet gets the Administrator mailbox object, and pipes it to the Get-RMEFolder cmdlet.

The Get-RMEFolder cmdlet gets the Inbox folder object, and pipes it to the Get-RMEMessage cmdlet.

The Get-RMEMessage cmdlet gets all messages whose Subject field contains the word confidential.

PS C:\> $source = Attach- RMEPersonalFolders "C:\psts\MyData.pst" -IsSource

PS C:\> Get-RMEMessage $source - TimeBefore "01.01.2000"

In the first line of this example, the Attach- RMEPersonalFolders cmdlet connects to the MyData.pst file as a source storage, and then saves the file object in the $source variable.

In the second line of this example, the Get- RMEMessage cmdlet retrieves messages that were received before 01.01.2000 from the .pst file object saved in the $source variable.

PS C:\> $source = Attach- RMEPersonalFolders "C:\psts\MyData.pst" -IsSource

PS C:\> Get-RMEMessage $source -TimeMatch sent -TimeAfter "01.01.2000"

In the first line of this example, the Attach- RMEPersonalFolders cmdlet connects to the MyData.pst file as a source storage, and then saves the file object in the $source variable.

In the second line of this example, the Get- RMEMessage cmdlet retrieves messages that were sent after 01.01.2000 from the .pst file object saved in the $source variable.

NOTE: When retrieving messages by date, the Get- RMEMessage cmdlet searches in the Received field by default. To search in other message fields, use the TimeMatch parameter.

Cmdlets for restoring data

The Management Shell provides cmdlets that allow you to restore folders, mailboxes, or messages. The names of such cmdlets have the format Restore-<Noun>.

Table 33: Cmdlets for restoring data

Cmdlet Description
Restore-RMEFolder Restores folders.
Restore-RMEMailbox Restores mailboxes.
Restore-RMEMessage Restores messages.

To restore data

  1. Connect to the item you wish to use as a storage by using one of the cmdlets described in Cmdlets for connecting to storages.
  2. Pass the output of the cmdlet you used in step 1 to one of the cmdlets that retrieve objects, as shown in the examples later in this procedure. For more information, see Cmdlets for retrieving (searching for) objects.
  3. Pass the output of the cmdlet you used in step 2 to one of the cmdlets that restore data, as shown in the next examples. To pass the output, you can use pipelining or a variable.

Table 34: Examples: Restoring data

Command Description

Attach-RMEExchangeDB C:\Demo\priv1.edb | Get-RMEMailbox "Administrator" | Restore-RMEMailbox -TargetPath "C:\Exported\PST"

 

The Attach-RMEExchangeDB cmdlet connects to the offline Exchange Server database priv1.edb, and then pipes the database object to the Get-RMEMailbox cmdlet.

The Get-RMEMailbox cmdlet gets the Administrator mailbox object, and pipes it to the Restore- RMEMailbox cmdlet.

The Restore-RMEMailbox cmdlet restores the entire Administrator mailbox to a .pst file in the folder C:\Exported\PST.

PS C:\> $target = Attach- RMEExchangeMailbox "Administrator" | Get-RMEFolder "Restored"

PS C:\> Attach-RMEExchangeDB "C:\Data\Edb\EdbSearchTest\EdbSearchTest .edb" | Get-RMEFolder "John Doe\Inbox" | Get-RMEMessage | Restore-RMEMessage - TargetFolder $target

In the first line of this example, the Attach- RMEExchangeMailbox cmdlet connects to the Administrator mailbox.

The mailbox object is then piped to the Get- RMEFolder cmdlet that retrieves the Restored folder from the mailbox. The Restored folder object is then saved in the $target variable.

In the second line of this example, a connection is established to the EdbSearchTest.edb mailbox store database, and all messages are retrieved from the Inbox folder in the John Doe mailbox. The retrieved messages are then restored to the folder saved in the $target variable.

PS C:\> $target = Attach- RMEExchangeMailbox "John Doe" | Get- RMEFolder "Restored"

PS C:\> Attach-RMEPersonalFolders "C:\PST\Data.pst" -IsSource | Get- RMEMessage -Text "data" -SearchIn Body,Subject,Attach | Restore-RMEMessage -TargetFolder $target

In the first line of this example, the Attach- RMEExchangeMailbox cmdlet connects to the John Doe mailbox.

The mailbox object is then piped to the Get- RMEFolder cmdlet that retrieves the Restored folder from the mailbox. The Restored folder object is then saved in the $target variable.

In the second line of this example, the Attach- RMEPersonalFolders cmdlet connects to the Data.pst file. Then, the Get-RMEMessage cmdlet retrieves all messages whose body, subject, or attachments include the word data. Then, the Restore-RMEMessage cmdlet restores these messages to the target folder saved in the $target variable.

Cmdlets for exporting data

The Management Shell provides cmdlets that allow you to export messages or attachments. The names of such cmdlets have the format Export-<Noun>.

Table 35: Cmdlets for exporting data

Cmdlet Description
Export-RMEAttachment Exports attachments to the location you specify.
Export-RMEMessage Exports messages to the format you specify or to Archive Manager.

Here is an example of how to export messages:

Table 36: Example: Exporting messages

Command Description

PS C:\> $messages = Attach-RMEExchangeDB "C:\Demo\priv1.edb" | Get-RMEMessage - Importance High

PS C:\> Export-RMEMessage -Messages $messages -Type MSG -ExportPath "C:\Exported\MSG"

In the first line of this example, the Attach- RMEExchangeDB establishes a connection to the priv1.edb offline Exchange Server database file.

The database will be used as a source storage. The database object is then piped to the Get- RMEMessage cmdlet that retrieves all the messages that have high importance and saves them to the $messages variable.

In the second line of this example, the Export- RMEMessage cmdlet exports each message saved in the $messages variable to an individual .msg file in the folder C:\Exported\MSG.

Related Documents