New-DPMRecoveryOption

New-DPMRecoveryOption

Creates recovery options.

Syntax

Parameter Set: ClientDatasourceRecoveryOption
New-DPMRecoveryOption [-TargetServer] <String> [-RecoveryLocation] <RecoveryLocation> -ClientDatasource -OverwriteType <OverwriteType> {Overwrite | NoOverwrite | CopyOnExist} -RecoveryType <RecoveryType> {Recover | Restore} [-AlternateLocation <String> ] [-DPMLibrary <Library> ] [-RecoverToReplicaFromTape <Boolean> ] [-RestoreSecurity] [-SANRecovery] [ <CommonParameters>]

Parameter Set: E14RecoveryOption
New-DPMRecoveryOption [-RecoveryLocation] <RecoveryLocation> [-TargetServer] <String> -E14Datasource -ExchangeOperationType <ExchangeOperationType> -RecoveryType <RecoveryType> {Recover | Restore} [-AlternateDatabase <String> ] [-DPMLibrary <Library> ] [-IsRecoveryDatabase] [-MountDatabaseAfterRestore] [-RecoverToReplicaFromTape <Boolean> ] [-RestoreSecurity] [-RollForwardRecovery] [-SANRecovery] [-TargetLocation <String> ] [ <CommonParameters>]

Parameter Set: ExchangeRecoveryOption
New-DPMRecoveryOption [-TargetServer] <String> [-RecoveryLocation] <RecoveryLocation> -Exchange -ExchangeOperationType <ExchangeOperationType> -RecoveryType <RecoveryType> {Recover | Restore} [-AlternateDatabase <String> ] [-AlternateStorageGroup <String> ] [-DatabaseName <String> ] [-DPMLibrary <Library> ] [-IsRecoveryStorageGroup] [-MailboxDisplayName <String> ] [-MountDatabaseAfterRestore] [-RecoverToReplicaFromTape <Boolean> ] [-RestoreSecurity] [-RollForwardRecovery] [-SANRecovery] [-StorageGroupName <String> ] [-TargetLocation <String> ] [ <CommonParameters>]

Parameter Set: FsRecoveryOption
New-DPMRecoveryOption [-TargetServer] <String> [-RecoveryLocation] <RecoveryLocation> -FileSystem -OverwriteType <OverwriteType> {Overwrite | NoOverwrite | CopyOnExist} -RecoveryType <RecoveryType> {Recover | Restore} [-AlternateLocation <String> ] [-DPMLibrary <Library> ] [-RecoverToReplicaFromTape <Boolean> ] [-RestoreSecurity] [-SANRecovery] [ <CommonParameters>]

Parameter Set: GenericDatasourceRecoveryOption
New-DPMRecoveryOption [-TargetServer] <String> [-RecoveryLocation] <RecoveryLocation> -GenericDatasource -RecoveryType <RecoveryType> {Recover | Restore} [-DPMLibrary <Library> ] [-RecoverToReplicaFromTape <Boolean> ] [-RestoreSecurity] [-SANRecovery] [-TargetLocation <String> ] [ <CommonParameters>]

Parameter Set: HyperVDatasourceRecoveryOption
New-DPMRecoveryOption [-TargetServer] <String> [-RecoveryLocation] <RecoveryLocation> -HyperVDatasource -RecoveryType <RecoveryType> {Recover | Restore} [-DPMLibrary <Library> ] [-RecoverToReplicaFromTape <Boolean> ] [-RestoreSecurity] [-SANRecovery] [-TargetLocation <String> ] [ <CommonParameters>]

Parameter Set: RecoverToDpm
New-DPMRecoveryOption [-TargetServer] <String> [-RecoveryLocation] <RecoveryLocation> -PrimaryDpmServer [-DPMLibrary <Library> ] [-RecoverToReplicaFromTape <Boolean> ] [ <CommonParameters>]

Parameter Set: SharePointRecoveryOption
New-DPMRecoveryOption [-TargetServer] <String> [-RecoveryLocation] <RecoveryLocation> -RecoveryType <RecoveryType> {Recover | Restore} -SharePoint [-DPMLibrary <Library> ] [-RecoverToReplicaFromTape <Boolean> ] [-RestoreSecurity] [-SANRecovery] [-TargetLocation <String> ] [ <CommonParameters>]

Parameter Set: SharePointSiteRecoveryOption
New-DPMRecoveryOption [-TargetServer] <String> [-RecoveryLocation] <RecoveryLocation> -DatabaseFileTempLocation <String> -ExportFileTempLocation <String> -IntermediateServer <String> -IntermediateSqlInstance <String> -RecoveryType <RecoveryType> {Recover | Restore} -SharePointSite [-DPMLibrary <Library> ] [-ItemLevelRecoveryType <SharepointRecoveryType> {RecoveryFarm | UnattachedInstance} ] [-RecoverToReplicaFromTape <Boolean> ] [-RestoreSecurity] [-SANRecovery] [-TargetLocation <String> ] [-TargetSiteUrl <String> ] [ <CommonParameters>]

Parameter Set: SQLRecoveryOption
New-DPMRecoveryOption [-TargetServer] <String> [-RecoveryLocation] <RecoveryLocation> -RecoveryType <RecoveryType> {Recover | Restore} -SQL [-AlternateDatabaseDetails <AlternateDatabaseDetailsType> ] [-CopyLogFiles] [-DPMLibrary <Library> ] [-LeaveDBInRestoringState] [-LogFileCopyLocation <String> ] [-RecoverToReplicaFromTape <Boolean> ] [-RestoreSecurity] [-RollForwardRecovery] [-SANRecovery] [-TargetLocation <String> ] [ <CommonParameters>]

Parameter Set: StagingAreaRestoreOption
New-DPMRecoveryOption [[-DPMServerName] <String> ] [-StagingAreaPath] <String> [-DestinationServerName] <String> [-DestinationPath] <String> [-DatasourceName] <String> [-OverwriteType] <OverwriteType> {Overwrite | NoOverwrite | CopyOnExist} [[-RestoreSecurity]] -DPMComponentName <Guid> [-DPMLibrary <Library> ] [-FileSystemDatasource] [-RecoverToReplicaFromTape <Boolean> ] [ <CommonParameters>]

Parameter Set: SystemProtectionRecoveryOption
New-DPMRecoveryOption [-TargetServer] <String> [-RecoveryLocation] <RecoveryLocation> -RecoveryType <RecoveryType> {Recover | Restore} -SystemProtectionDatasource [-DPMLibrary <Library> ] [-RecoverToReplicaFromTape <Boolean> ] [-RestoreSecurity] [-SANRecovery] [-TargetLocation <String> ] [ <CommonParameters>]

Detailed Description

The New-DPMRecoveryOption cmdlet creates recovery options for file servers, computers running Exchange Server, SharePoint Server, and SQL Server, and other data sources.

Parameters

-AlternateDatabase<String>

Specifies the name of an alternate database for recovery.

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-AlternateDatabaseDetails<AlternateDatabaseDetailsType>

Specify the type of the alternate database.

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-AlternateLocation<String>

Specifies an alternate location where DPM creates a recovery point.

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-AlternateStorageGroup<String>

Specifies an alternate storage group for a new recovery point.

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-ClientDatasource

Indicates that the restored data is a file system or an application.

Aliases	none
Required?	true
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-CopyLogFiles

Indicates that DPM copies the log files.

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-DatabaseFileTempLocation<String>

Specifies a temporary location for the database file.

Aliases	none
Required?	true
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-DatabaseName<String>

Specify the name of the database.

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-DatasourceName<String>

Specifies the name of the data source.

Aliases	none
Required?	true
Position?	5
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-DestinationPath<String>

Specifies the recovery location.

Aliases	none
Required?	true
Position?	4
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-DestinationServerName<String>

Specifies the name of the server to which DPM recovers data.

Aliases	none
Required?	true
Position?	3
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-DPMComponentName<Guid>

Specifies the GUID of the data source you are recovering.

Aliases	none
Required?	true
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-DPMLibrary<Library>

Specifies a DPM library object. To obtain a DPM library object, use the Get-DPMLibrary cmdlet.

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-DPMServerName<String>

Specifies the name of a DPM server. If you do not specify a name, the cmdlet uses the name of the current computer.

Aliases	none
Required?	false
Position?	1
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-E14Datasource

Indicates that the data source is Exchange Server 2010.

Aliases	none
Required?	true
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-Exchange

Indicates that DPM performs the current operation on a Microsoft Exchange data source.

Aliases	none
Required?	true
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-ExchangeOperationType<ExchangeOperationType>

Specifies the type of operation that DPM performs on a Microsoft Exchange data source. Valid values are:

-- NoOperation
-- MailBoxLevelRecovery
-- NeedCleanShutdown

Aliases	none
Required?	true
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-ExportFileTempLocation<String>

Specifies the location of the export file.

Aliases	none
Required?	true
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-FileSystem

Indicates that DPM performs the current operation on a file system data source.

Aliases	none
Required?	true
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-FileSystemDatasource

Indicates that you are recovering a file system data source.

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-GenericDatasource

Indicates that DPM performs the current operation on a data source such as Microsoft Virtual Server.

Aliases	none
Required?	true
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-HyperVDatasource

Indicates that the data source is Hyper-V.

Aliases	none
Required?	true
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-IntermediateServer<String>

Specifies the server that DPM uses for SharePoint site recovery.

Aliases	none
Required?	true
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-IntermediateSqlInstance<String>

Specifies a SQL Server instance that DPM uses for SharePoint site recovery. DPM uses the SQL Server instance to temporarily host a SQL Server database.

Aliases	none
Required?	true
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-IsRecoveryDatabase

Indicates that the database is a recovery database.

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-IsRecoveryStorageGroup

Indicates that the recovery is a recovery storage group.

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-ItemLevelRecoveryType<SharepointRecoveryType>

Specifies the recovery type. Valid values are:

-- RecoveryFarm
-- UnattachedInstance

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-LeaveDBInRestoringState

Indicates that DPM leaves the database non-operational but in a restorable state. Specify this parameter to leave the database operational.

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-LogFileCopyLocation<String>

Specifies the location where DPM copies log files.

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-MailboxDisplayName<String>

Specifies a name that DPM displays on the mailbox.

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-MountDatabaseAfterRestore

Indicates that DPM mounts the database after it restores the database.

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-OverwriteType<OverwriteType>

Specifies the action that DPM takes when the file it is recovering already exists. Valid values are:
-- CreateCopy
-- Skip
-- Overwrite

Aliases	none
Required?	true
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-PrimaryDpmServer

Indicates that the server where DPM recovers data is a DPM server.

Aliases	none
Required?	true
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-RecoverToReplicaFromTape<Boolean>

Indicates whether recovery to the replica is from a tape.

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-RecoveryLocation<RecoveryLocation>

Specifies the location where DPM recovers data. Valid values are:
-- OriginalServer
-- CopyToFolder
-- OriginalServerWithDBRename
-- AlternateExchangeServer
-- ExchangeServerDatabase

Aliases	none
Required?	true
Position?	2
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-RecoveryType<RecoveryType>

Specifies the recovery type. If you specify the HyperVDatasource parameter, the only valid value is Recover. Valid values are: Recover or Restore.

Aliases	none
Required?	true
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-RestoreSecurity

Indicates that DPM uses the security settings from the recovery point. If you do not specify this parameter, DPM uses the security settings of the destination server.

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-RollForwardRecovery

Indicates that DPM recovers the application from the latest recovery point and applies all logs after that recovery point to bring the application to the latest state.

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-SANRecovery

Indicates that DPM performs the current operation on a Storage Area Network (SAN) data source.

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-SharePoint

Indicates that DPM performs the current operation on a SharePoint data source.

Aliases	none
Required?	true
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-SharePointSite

Indicates that DPM performs the current operation on a SharePoint site.

Aliases	none
Required?	true
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-SQL

Indicates that DPM performs the current operation on a SQL Server data source.

Aliases	none
Required?	true
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-StagingAreaPath<String>

Specifies the path of the staging area.

Aliases	none
Required?	true
Position?	2
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-StorageGroupName<String>

Specifies the name of the storage group.

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-SystemProtectionDatasource

Indicates that DPM performs the current operation on a system protection data source.

Aliases	none
Required?	true
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-TargetLocation<String>

Specify the location where DPM stores the replica.

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-TargetServer<String>

Specifies the target server for recovery.

If you use this cmdlet in a clustered environment, specify the target server parameter in the format ResourceGroupName.ClusterName.DomainName.

Aliases	none
Required?	true
Position?	1
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-TargetSiteUrl<String>

Specifies the URL of the target where DPM recovers data.

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see    about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

Outputs

The output type is the type of the objects that the cmdlet emits.

• RecoveryOption

Notes

• For more information, type "Get-Help New-DPMRecoveryOption -detailed".

Examples

Example 1: Recover a file system

This command creates a recovery option that restores the file system to west.domain.com and restores the original security settings.

PS C:\> New-DPMRecoveryOption -TargetServer "west.contoso.com" -RecoveryLocation "d:\copytofolder" -FileSystem -AlternateLocation "f:\restore" -OverwriteType overwrite -RestoreSecurity -RecoveryType Restore

Example 2: Recover a file system by using a replica

The example outlines the sequence of commands that you can use to recover a file server by using the replica.

The first command opens a connection to a DPM server.

The second command gets the computer named DPMServer01 on which the DPM protection agent is installed. The command stores the result in the $Ps variable.

The third command gets the list of protected and unprotected data on the production server stored in the $Ps variable. The command stores the result in the $Ds variable.

The fourth command gets the libraries associated with the DPM server named DPoreMServer01. The command stores the result in the $Rp variable.

The fifth command gets the recovery point for the data source stored in the $Ds variable, and stores the result in the $Rp variable.

The sixth command creates a recovery option on a file system data source. The command specifies that data is recovered to the replica on the target server named DPMServer02 from a tape.

PS C:\> Connect-DPMServer -DPMServerName "DPMServer01"
PS C:\> $Ps = Get-DPMProductionServer -DPMServerName "DPMServer01"
PS C:\> $Ds = Get-DPMDatasource -ProductionServer $Ps
PS C:\> $Dl = Get-DPMLibrary -DPMServerName "DPoreMServer01"
PS C:\> $Rp = Get-DPMRecoveryPoint -Datasource $Ds
PS C:\> $Rop = New-DPMRecoveryOption -Filesystem -RecoverToReplicaFromTape $True -RecoveryLocation DPMReplicaVolume -DPMLibrary $dl[0] -Targetserver "DPMServer02" -Overwritetype overwrite

Example 3: Recover a file system from a replica on tape

This example

The example outlines the sequence of commands that you can use to recover a file server from a replica on tape to the specified recovery location.

The first command gets the protection group on the DPM server named DPMServer02. The command stores the result in the $Pg variable.

The second command gets the list of protected and unprotected data on the production server stored in the $Ps variable. The command stores the result in the $Ds variable.

The third command gets the recovery point for the data source stored in the $Ds variable, and stores the result in the $Rp variable.

The fourth command gets the libraries associated with the DPM server named DPoreMServer01. The command stores the result in the $Lib variable.

The fifth command creates a recovery option on a file system data source. The command specifies that data is recovered to the replica on the target server named DPMServer02 from a tape.

The sixth command restores a version of the data source stored in the $Rp variable by using the recovery option stored the $Rop variable.

PS C:\> $Pg = Get-DPMProtectionGroup -DPMServerName "DPMServer02"
PS C:\> $Ds = Get-DPMDatasource -ProductionServer $Pg
PS C:\> $Rp = Get-DPMRecoveryPoint -Datasource $Ds
PS C:\> $Lib = Get-DPMLibrary -DPMServerName "DPoreMServer01"
PS C:\> $Rop = New-DPMRecoveryOption -RecoverToReplicaFromTape $True -RecoveryLocation DPMReplicaVolume -FileSystem -TargetServer "DPMServer02" -OverwriteType Overwrite -RecoveryType Recover -DpmLibrary $Lib
PS C:\> Restore-DPMRecoverableItem -RecoverableItem $Rp -RecoveryOption $Rop

Related topics

Get-DPMProtectionGroup

Get-DPMDatasource

Get-DPMRecoveryPoint

Get-DPMLibrary

Restore-DPMRecoverableItem

Get-DPMLibrary