Restoremailbox command

To restore mailbox-level data or mailbox-item-level data from Tivoli® Storage FlashCopy® Manager for Exchange Server backups, use the restoremailbox command.

The restoremailbox command applies to any Data Protection for Exchange Server VSS backups:

VSS backups that are stored on Tivoli Storage Manager server
VSS backups that are stored on local shadow volumes

When you use the restoremailbox command, follow these guidelines:

Ensure that you have the required role-based access control (RBAC) permissions to complete individual mailbox restore operations.
You can restore multiple mailboxes in a single mailbox restore operation.
You can use the restoremailbox command to restore data to a mailbox on the Exchange Server or to an Exchange Server.pst file.
When you restore to a Unicode .pst file, except for the Folder Name and All Content filters, the filters are ignored. The amount of time that is needed to complete the restore process depends on the size of the mailbox databases, the network speed, and the number of mailboxes to process.
For non-Unicode .pst files, you can limit the range of the mailbox data to restore by using the /mailboxfilter parameter to specify filters that are based on the following mailbox message elements:
- Sender name
- Folder name
- Message body
- Subject line
- Attachment name
- Range of the message delivery date and time
In Exchange 2013, you can use the restoremailbox command to restore a public folder mailbox database, a public folder mailbox, or only a part of the mailbox, for example, a specific public folder.
- To restore an Exchange 2013 public folder mailbox, you must have the Public Folders management role.
- You can restore a public folder mailbox only to an existing public folder mailbox that is on the Exchange server.
- You can restore a public folder only to an existing public folder. The public folder on the Exchange server must have the same folder path as the public folder to be restored. If the public folder is deleted from the public folder mailbox on the Exchange server, you must re-create the public folder with the same folder path as the public folder to be restored, before you start the restore operation.
- As a best practice, restore public folder mailboxes separately from user mailboxes. Select only one public folder mailbox to restore at a time if you want to restore a specific public folder in the mailbox, or if you want to restore to a different public folder mailbox than the original mailbox.
  If you restore multiple mailboxes in a single restore operation, and at least one of the mailboxes is a public folder mailbox, the mailboxes are restored only to their original mailbox locations. You cannot specify a filter or an alternate mailbox destination.
- You can restore to a different public folder mailbox than the original mailbox if, for example, the public folder was relocated since the time of the backup. Before you complete the public folder restore operation, ensure that the public folder exists with the same folder path in the alternate mailbox location.
In Exchange Server 2010 or later, you can use the restoremailbox command to restore an archive mailbox or only a part of the mailbox, for example, a specific folder. You can restore archive mailbox messages to an existing mailbox on the Exchange server, to an archive mailbox, or to an Exchange Server .pst file.
You can use the restoremailbox command with the following parameter and options:
- Set the /KEEPRDB parameter option to Yes to retain a recovery database after one or more mailboxes are restored. Set the parameter value to No to automatically remove the recovery database after mailbox restore processing.
  Regardless of the option that you set, retains the recovery database if the mailbox restore operation fails after the recovery database is successfully restored.
  
  If you restore multiple mailboxes, and you want to retain the recovery database after the restore operation is complete, ensure that all mailboxes are in the same recovery database.
- Set the /USEEXISTINGRDB parameter option to Yes to restore a mailbox from an existing recovery database. Set the parameter value to No to automatically remove the existing recovery database during mailbox restore processing.
- Set the /mailboxoriglocation parameter to specify the server and the database where the mailbox is at the time of backup. You set this option when the mailbox history is disabled and when the mailbox that you are restoring is either moved or deleted since the time of the backup.
- If a mailbox is deleted or re-created since the time of the backup, you must use a temporary mailbox with enough capacity to contain all of the mailbox items that you are restoring. The mailbox of the user who is logged in is used as temporary mailbox by default.
  You can set the /tempmailboxalias optional parameter by selecting Properties from the Actions pane. In the Data Protection Properties window, select the General page, where you can specify the temporary log restore path, the temporary database restore path and the alias of the temporary mailbox.
You can use the restoremailbox command on the primary Exchange Server or on an alternate Exchange Server that is in the same domain.