Extract-RMEExchangeDB

From PowerGUI Wiki

Jump to: navigation, search

Extracts Exchange Server database files from the backups you specify.

Contents

Syntax

Extract-RMEExchangeDB [-MediaType] <String> [-MediaNames <String[]>] [-BackupServer <String>] [-ServerPassword <String>] [-LegatoClientName <String>] [-TivoliNodeName <String>] [-TivoliProtocol <String>] -ExtractPath <String> [-ExchangeServers <String[]>] [-StorageGroups <String[]>] [-Stores <String[]>] [-BackupDateBefore <DateTime>] [-BackupDateAfter <DateTime>] [<CommonParameters>]

Detailed Description

Extracts Exchange Server database files from the backups you specify. You can use this cmdlet to extract Exchange Server databases from specific backup files or from backup files located in specific folders, tape drives, or on particular backup servers. Optionally, you can filter the Exchange Server database files being extracted by the names of the source Exchange Server computers, storage groups, or stores or by certain backup creation dates.



Related Commands

Parameters

Name Description Required? Pipeline Input Default Value
MediaType Specifies the type of the backup media from which you want to extract Exchange Server databases. This parameter can take one of the following values:
  • Directories - Extracts Exchange Server databases from backup files located in specific folders.
  • Files - Extracts Exchange Server databases from specific backup files.
  • TapeDrives - Extracts Exchange Server databases from backups in the tape drive you specify.
  • LegatoServer - Extracts Exchange Server databases from backups held on an EMC Legato NetWorker server.
  • TivoliServer - Extracts Exchange Server databases from backups held on an IBM Tivoli Storage Manager server.
  • DpmServer - Extracts Exchange Server databases from backups held on a Microsoft Data Protection Manager server.
true false
MediaNames Specifies the names of the backup files, folders holding backups, or tape drives from which you want to extract Exchange Server databases. All media whose names you specify in this parameter must belong to the same media type set in the MediaType parameter. false false
BackupServer Specifies the name of the backup server that holds the backups from which you want to extract Exchange Server databases. false false
ServerPassword Specifies the password with which you want to access the IBM Tivoli Storage Manager server whose name you entered in the BackupServer parameter. false false
LegatoClientName Specifies the name of the EMC Legato NetWorker client that created the backups you want to retrieve from the EMC Legato NetWorker server. false false
TivoliNodeName Specifies the name of the IBM Tivoli Storage Manager node that created the backups you want to retrieve from the IBM Tivoli Storage Manager server. false false
TivoliProtocol Specifies the protocol to be used to connect to the IBM Tivoli Storage Manager server whose name you entered in the BackupServer parameter.

You can specify one of the following protocols:

  • TCP/IP - To specify this protocol, use the following syntax:

TCPIP:<PortNumber> where <PortNumber> is the number of the TCP/IP port you want to use.

  • Named Pipes - To specify this protocol, use the following syntax:

NamedPipes:<PipeName> where <PipeName> is the name of the pipe you want to use.

false false
ExtractPath Specifies the path to the folder where you want to extract the Exchange Server database files from backups. true false
ExchangeServers Specifies the names of the Exchange Server computers whose database files you want to extract from backups. false false
StorageGroups Specifies the names of the Exchange Server storage groups that hold the database files you want to extract from backups. false false
Stores Specifies the names of the Exchange Server stores whose database files you want to extract from backups. false false
BackupDateBefore Specifies the date after which the backups you want to extract were created. This parameter accepts the following date format:

MM/DD/YYYY

false false
BackupDateAfter Specifies the date before which the backups you want to extract were created. This parameter accepts the following date format:

MM/DD/YYYY

false false

Examples

Example 1

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.

Personal tools