Recovery Manager for Exchange 5.8.6

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 35: 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 36: Examples: Running, stopping, or getting automated tasks

Command	Description
Get-RMETask \| Where { $_.name -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 { $_.name -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.

Command

Description

Get-RMETask | Where { $_.name -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 { $_.name -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 37: 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 38: 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 mydomain.com - 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 mydomain.com. 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.

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 mydomain.com - 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 mydomain.com. 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

Restoring online mailboxes to individual .pst files

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

Table 39: 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.

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.

Please select your product:

To serve you better, please complete the Purpose of your Chat:

Recommended Solutions for Your Problem

Recovery Manager for Exchange 5.8.6 - User Guide

Cmdlets for managing automated tasks

Other cmdlets

Usage scenarios

Restoring online mailboxes to individual .pst files