Export-RMEMessage
From PowerGUI Wiki
Exports messages to the file format you specify or to Quest Archive Manager.
Contents |
Syntax
Export-RMEMessage [-Messages] <Object> [-Type] <String> [-ExportPath] <String> [-MaintainFolderStructure] [-GenerateHash] [-NamingOptions <TargetNamingOptions>] [-ApplySecurity] [-UnicodeMessage] [-ArchiveManagerVersion <String>] [<CommonParameters>]
Export-RMEMessage [-UnicodeMessage] [<CommonParameters>]
Detailed Description
The Export-RMEMessage cmdlet exports messages to the file format you specify or to Quest Archive Manager.
Related Commands
Parameters
| Name | Description | Required? | Pipeline Input | Default Value |
|---|---|---|---|---|
| Messages | Specifies the messages you want to export. Enter a variable that contains the message objects or type a command or expression that gets the message objects. | true | true (ByValue, ByPropertyName) | |
| Type | Specifies the target format to export messages to. This parameter can take one of the following values for the target format:
| true | false | |
| ExportPath | Specifies the path to the location where target files will be created. | true | false | |
| MaintainFolderStructure | Specifies to create the original source storage folder hierarchy in the target location. If you use this parameter, target files are generated in the appropriate level of the hierarchy to reflect the location of the exported messages in the source storage. | false | false | |
| GenerateHash | Specifies to create an .md5 hash file for each generated target file. The .md5 hash files are created in the same folder as the target files. | false | false | |
| NamingOptions | Specifies naming options for the generated target files.
This parameter can take one or both of the following values:
If specifying both values, delimit them with a comma. This parameter is ignored unless you restore messages to new target files. | false | false | |
| ApplySecurity | Applies the access permissions you set in the Recovery Manager console to the new target files generated in the result of the restore operation. | false | false | |
| UnicodeMessage | Specifies to export each message to an individual Outlook Message (.msg) file in the Unicode format. This format enables you to retain readability of texts written in most languages. Generated Unicode .msg files are not compatible with Outlook 97, 98, 2000, and 2002.
This parameter is ignored unless the Type parameter is set to Msg. | false | false | |
| ArchiveManagerVersion | Specifies the Archive Manager version into which the messages will be imported. The Archive Manager version must be specified in the following format:
x.x This parameter is ignored unless the Type parameter is set to ArchiveManager. | false | false |
Examples
Example 1
Attach-RMEExchangeDB -EdbPath "C:\Data\Edb\EdbSearchTest\EdbSearchTest.edb" | Get-RMEMessage | Export-RMEMessage -ExportPath "C:\Data\Exported\Msg" -Type Msg
The Attach-RMEExchangeDB cmdlet connects to the EdbSearchTest.edb mailbox store database and pipes it to the Get-RMEMessage cmdlet. The Get-RMEMessage cmdlet then retrieves all messages from the mailbox store database and pipes them to the Export-RMEMessage cmdlet that saves each message as a .msg file in the “C:\Data\Exported\Msg” folder.
Example 2
Attach-RMEExchangeDB "C:\Data\Edb\EdbSearchTest\EdbSearchTest.edb" | Get-RMEMessage -SearchIn Subject -Text "test" | Export-RMEMessage -ExportPath "C:\Data\Exported\AM" -Type ArchiveManager -ArchiveManagerVersion 3.8
The Attach-RMEExchangeDB cmdlet connects to the EdbSearchTest.edb mailbox store database and pipes it to the Get-RMEMessage cmdlet. The Get-RMEMessage cmdlet then retrieves all messages whose subject contains the word "test" and pipes them to the Export-RMEMessage cmdlet that saves the messages in the Quest Archive Manager drop directory (C:\Data\Exported\AM) for their subsequent import into Archive Manager version 3.8.
Example 3
Attach-RMELotusDB "C:\Data\Nsf" | Get-RMEMessage -SearchIn Subject, Body -Text "test" | Export-RMEMessage -ExportPath "C:\Data\Exported\Eml" -Type Eml
The Attach-RMELotusDB cmdlet connects to all Lotus Notes databases (.nsf files) found in the "C:\Data\Nsf" folder. The .nsf file objects are then piped to the Get-RMEMessage cmdlet that retrieves all messages whose subject or body includes the word "test". The retrieved message objects are then piped to the Export-RMEMessage cmdlet that saves each message as an .eml file in the "C:\Data\Exported\Eml" folder.
Example 4
Attach-RMEPersonalDB "C:\Data\Pst\MapiTest.pst" | Get-RMEMessage | Export-RMEMessage -ExportPath "C:\Data\Exported\Txt" -Type Txt
The Attach-RMEPersonalDB cmdlet connects to the MapiTest.pst file and pipes it to the Get-RMEMessage cmdlet that retrieves all messages from the file. The retrieved message objects are then piped to the Export-RMEMessage cmdlet that saves each message as a .txt file in the "C:\Data\Exported\Txt" folder.
