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 { $_.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. |
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 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. |
This section covers the following scenarios:
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. |
© ALL RIGHTS RESERVED. Terms of Use Privacy Cookie Preference Center
