Restore-RMEFolder

From PowerGUI Wiki

Jump to: navigation, search

Restores specific folders.

Contents

Syntax

Restore-RMEFolder [-SourceFolders] <Object> [[-TargetFolder] <IMapiContainer>] [[-TargetPath] <String>] [[-NamePrefix] <String>] -AnsiPst [[-FolderPath] <String>] [[-NamingOptions] <TargetNamingOptions>] -ApplySecurity [-DuplicateAction <DuplicateAction>] [<CommonParameters>]

Detailed Description

The Restore-RMEFolder cmdlet restores specific folders.



Related Commands

Parameters

Name Description Required? Pipeline Input Default Value
SourceFolders Specifies the folders to be restored. Enter a variable that contains the folder objects or type a command or expression that gets the folder objects. true true (ByValue, ByPropertyName)
TargetFolder Specifies the target folder to restore the folders to. Enter a variable that contains the target folder object or type a command or expression that gets the target folder object. false false
TargetPath Specifies the name of the folder where target Personal Folders (.pst) files will be generated. This parameter is ignored unless you restore folders to new Personal Folders (.pst) files. false false
NamePrefix Specifies the custom prefix to be added to the names of generated target Personal Folders (.pst) files. This parameter is ignored unless you restore folders to new Personal Folders (.pst) files. false false
AnsiPst Specifies to restore each folder to a new individual Personal Folders (.pst) file in the ANSI format. false false
FolderPath Specifies the path to the target folder in a storage or file where you want to place the restored folders. false false
NamingOptions Specifies naming options for the generated target Personal Folders (.pst) files.

This parameter can take one or both of the following values:

  • 'IncludeStoreName' - Adds the source storage name as a prefix to the names of target .pst files.
  • 'IncludeTimeStamp' - Appends the date and time of creation of target .pst files to their names.

If specifying both values, delimit them with a comma. This parameter is ignored unless you restore folders to new Personal Folders (.pst) files.

false false
ApplySecurity Applies access permissions to the new target Personal Folders (.pst) files generated in the result of the restore operation. false false
DuplicateAction Specifies how to handle message duplicates during the restore operation.

This parameter can take one of the following values:

  • 'Copy' - The messages you are restoring will not overwrite any of their duplicates located in target storages or files. The restored messages and their duplicates will coexist in target storages or files.
  • 'Overwrite' - The messages you are restoring will overwrite all their duplicates in target storages or files without any warning.
  • 'OverwriteIfNewer' - The messages you are restoring will overwrite their duplicates in target storages or files only if these duplicates are older than the messages being restored.
  • 'Skip' - The messages whose duplicates are found in target storages or files will not be restored.
false false

Examples

Example 1

Attach-RMEExchangeDB "C:\Data\Edb\EdbSearchTest\EdbSearchTest.edb" | Get-RMEFolder "John Doe\Inbox" | Restore-RMEFolder -TargetPath "C:\Data\Restored\Pst"

The Attach-RMEExchangeDB cmdlet connects to the EdbSearchTest.edb mailbox store database and pipes it to the Get-RMEFolder cmdlet that retrieves the Inbox folder from the John Doe mailbox. The Restore-RMEFolder cmdlet then restores the retrieved Inbox folder to a new .pst file in the "C:\Data\Restored\Pst" folder.

Retrieved from "http://wiki.powergui.org/index.php/Restore-RMEFolder"
Personal tools