New-DPMRecoveryOption

Creates recovery options.

Syntax

New-DPMRecoveryOption
   [[-DPMServerName] <String>]
   [-DPMLibrary <Library>]
   [-RecoverToReplicaFromTape <Boolean>]
   [-OverwriteType] <OverwriteType>
   [-RestoreSecurity]
   [-StagingAreaPath] <String>
   [-DestinationServerName] <String>
   [-DestinationPath] <String>
   [-DatasourceName] <String>
   -DPMComponentName <Guid>
   [-FileSystemDatasource]
   [<CommonParameters>]
New-DPMRecoveryOption
   [-TargetServer] <String>
   [-RecoveryLocation] <RecoveryLocation>
   [-DPMLibrary <Library>]
   [-RecoverToReplicaFromTape <Boolean>]
   [-SANRecovery]
   [-FileSystem]
   [-AlternateLocation <String>]
   [-OverwriteType] <OverwriteType>
   [-RestoreSecurity]
   -RecoveryType <RecoveryType>
   [<CommonParameters>]
New-DPMRecoveryOption
   [-TargetServer] <String>
   [-RecoveryLocation] <RecoveryLocation>
   [-DPMLibrary <Library>]
   [-RecoverToReplicaFromTape <Boolean>]
   [-SANRecovery]
   [-RestoreSecurity]
   [-SQL]
   -RecoveryType <RecoveryType>
   [-RollForwardRecovery]
   [-TargetLocation <String>]
   [-AlternateDatabaseDetails <AlternateDatabaseDetailsType>]
   [-LeaveDBInRestoringState]
   [-CopyLogFiles]
   [-LogFileCopyLocation <String>]
   [<CommonParameters>]
New-DPMRecoveryOption
   [-TargetServer] <String>
   [-RecoveryLocation] <RecoveryLocation>
   [-DPMLibrary <Library>]
   [-RecoverToReplicaFromTape <Boolean>]
   [-SANRecovery]
   [-RestoreSecurity]
   -RecoveryType <RecoveryType>
   [-TargetLocation <String>]
   [-SharePoint]
   [<CommonParameters>]
New-DPMRecoveryOption
   [-TargetServer] <String>
   [-RecoveryLocation] <RecoveryLocation>
   [-DPMLibrary <Library>]
   [-RecoverToReplicaFromTape <Boolean>]
   [-SANRecovery]
   [-RestoreSecurity]
   -RecoveryType <RecoveryType>
   [-TargetLocation <String>]
   [-SharePointSite]
   -DatabaseFileTempLocation <String>
   -IntermediateServer <String>
   -IntermediateSqlInstance <String>
   -ExportFileTempLocation <String>
   [-TargetSiteUrl <String>]
   [-ItemLevelRecoveryType <SharepointRecoveryType>]
   [<CommonParameters>]
New-DPMRecoveryOption
   [-TargetServer] <String>
   [-RecoveryLocation] <RecoveryLocation>
   [-DPMLibrary <Library>]
   [-RecoverToReplicaFromTape <Boolean>]
   [-SANRecovery]
   [-RestoreSecurity]
   -RecoveryType <RecoveryType>
   [-TargetLocation <String>]
   [-GenericDatasource]
   [<CommonParameters>]
New-DPMRecoveryOption
   [-TargetServer] <String>
   [-RecoveryLocation] <RecoveryLocation>
   [-DPMLibrary <Library>]
   [-RecoverToReplicaFromTape <Boolean>]
   [-SANRecovery]
   [-RestoreSecurity]
   -RecoveryType <RecoveryType>
   [-TargetLocation <String>]
   [-HyperVDatasource]
   [<CommonParameters>]
New-DPMRecoveryOption
   [-TargetServer] <String>
   [-RecoveryLocation] <RecoveryLocation>
   [-DPMLibrary <Library>]
   [-RecoverToReplicaFromTape <Boolean>]
   [-SANRecovery]
   [-AlternateLocation <String>]
   [-OverwriteType] <OverwriteType>
   [-RestoreSecurity]
   -RecoveryType <RecoveryType>
   [-ClientDatasource]
   [<CommonParameters>]
New-DPMRecoveryOption
   [-TargetServer] <String>
   [-RecoveryLocation] <RecoveryLocation>
   [-DPMLibrary <Library>]
   [-RecoverToReplicaFromTape <Boolean>]
   [-SANRecovery]
   [-RestoreSecurity]
   -RecoveryType <RecoveryType>
   [-TargetLocation <String>]
   [-SystemProtectionDatasource]
   [<CommonParameters>]
New-DPMRecoveryOption
   [-TargetServer] <String>
   [-RecoveryLocation] <RecoveryLocation>
   [-DPMLibrary <Library>]
   [-RecoverToReplicaFromTape <Boolean>]
   [-SANRecovery]
   [-RestoreSecurity]
   -RecoveryType <RecoveryType>
   [-RollForwardRecovery]
   [-TargetLocation <String>]
   [-Exchange]
   [-AlternateDatabase <String>]
   [-AlternateStorageGroup <String>]
   [-IsRecoveryStorageGroup]
   [-MountDatabaseAfterRestore]
   -ExchangeOperationType <ExchangeOperationType>
   [-MailboxDisplayName <String>]
   [-DatabaseName <String>]
   [-StorageGroupName <String>]
   [<CommonParameters>]
New-DPMRecoveryOption
   [-TargetServer] <String>
   [-RecoveryLocation] <RecoveryLocation>
   [-DPMLibrary <Library>]
   [-RecoverToReplicaFromTape <Boolean>]
   [-SANRecovery]
   [-RestoreSecurity]
   -RecoveryType <RecoveryType>
   [-RollForwardRecovery]
   [-TargetLocation <String>]
   [-E14Datasource]
   [-AlternateDatabase <String>]
   [-IsRecoveryDatabase]
   [-MountDatabaseAfterRestore]
   -ExchangeOperationType <ExchangeOperationType>
   [<CommonParameters>]
New-DPMRecoveryOption
   [-TargetServer] <String>
   [-RecoveryLocation] <RecoveryLocation>
   [-DPMLibrary <Library>]
   [-RecoverToReplicaFromTape <Boolean>]
   [-PrimaryDpmServer]
   [<CommonParameters>]

Description

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

Examples

Example 1: Recover a file system

PS C:\>New-DPMRecoveryOption -TargetServer "tsqa.contoso.com" -RecoveryLocation "D:\copytofolder" -FileSystem -AlternateLocation "F:\restore" -OverwriteType Overwrite -RestoreSecurity -RecoveryType Restore

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

Example 2: Recover a file system by using a replica

PS C:\>Connect-DPMServer -DPMServerName "DPMServer01"
PS C:\> $PServer = Get-DPMProductionServer -DPMServerName "DPMServer01"
PS C:\> $PObjects = Get-DPMDatasource -ProductionServer $PServer
PS C:\> $DpmLibrary = Get-DPMLibrary -DPMServerName "DPoreMServer01"
PS C:\> $RPoint = Get-DPMRecoveryPoint -Datasource $PObjects
PS C:\> $ROption = New-DPMRecoveryOption -Filesystem -RecoverToReplicaFromTape $True -RecoveryLocation DPMReplicaVolume -DPMLibrary $DpmLibrary[0] -TargetServer "DPMServer02" -OverwriteType Overwrite

The first command opens a connection to a DPM server.

The second command gets the computer named DPMServer01. The DPM protection agent is installed on this server. The command stores the server in the $PServer variable.

The third command gets the list of protected and unprotected data on the protection server in $PServer. The command stores the result in the $PObject variable.

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

The fifth command gets the recovery point for the data source in $PObject, and then stores that recovery point result in the $RPoint 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.

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

PS C:\>$PGroup = Get-DPMProtectionGroup -DPMServerName "DPMServer02"
PS C:\> $PObject = Get-DPMDatasource -ProductionServer $PGroup
PS C:\> $RPoint = Get-DPMRecoveryPoint -Datasource $PObject
PS C:\> $DpmLibraries = Get-DPMLibrary -DPMServerName "DPoreMServer01"
PS C:\> $ROption = New-DPMRecoveryOption -RecoverToReplicaFromTape $True -RecoveryLocation DPMReplicaVolume -FileSystem -TargetServer "DPMServer02" -OverwriteType Overwrite -RecoveryType Recover -DpmLibrary $DpmLibraries
PS C:\> Restore-DPMRecoverableItem -RecoverableItem $RPoint -RecoveryOption $ROption

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

The second command gets the protected and unprotected data on the production server in $PServer. The command stores the results in the $PObject variable.

The third command gets the recovery point for the data source in $PObject, and stores that recovery point in the $RPoint variable.

The fourth command gets the libraries associated with the DPM server named DPoreMServer01. The command stores the libraries in the $DpmLibraries 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 in $RPoint by using the recovery option in $ROption.

Parameters

-AlternateDatabase

Specifies the name of an alternate database for recovery.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AlternateDatabaseDetails

Specifies the type of the alternate database.

Type:AlternateDatabaseDetailsType
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AlternateLocation

Specifies an alternate location where System Center 2019 - Data Protection Manager (DPM) creates a recovery point.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AlternateStorageGroup

Specifies an alternate storage group for a new recovery point.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ClientDatasource

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

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-CopyLogFiles

Indicates that DPM copies the log files.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DatabaseFileTempLocation

Specifies a temporary location for the database file.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-DatabaseName

Specifies the name of the database.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DatasourceName

Specifies the name of the data source.

Type:String
Position:5
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-DestinationPath

Specifies the recovery location.

Type:String
Position:4
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-DestinationServerName

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

Type:String
Position:3
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-DPMComponentName

Specifies the GUID of the data source that DPM recovers.

Type:Guid
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-DPMLibrary

Specifies a DPM library object for which this cmdlet creates a recovery option. To obtain a DPM library object, use the Get-DPMLibrary cmdlet.

Type:Library
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DPMServerName

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

Type:String
Position:1
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-E14Datasource

Indicates that the data source is Exchange Server 2010.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Exchange

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

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ExchangeOperationType

Specifies the type of operation that DPM performs on a Exchange Server data source.

The acceptable values for this parameter are:

  • NoOperation
  • MailBoxLevelRecovery
  • NeedCleanShutdown
Type:ExchangeOperationType
Accepted values:NoOperation, MailBoxLevelRecovery, NeedCleanShutdown
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ExportFileTempLocation

Specifies the location of the export file.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-FileSystem

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

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-FileSystemDatasource

Indicates that DPM recovers a file system data source.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
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.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-HyperVDatasource

Indicates that the data source is nextref_virtualname.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-IntermediateServer

Specifies the server that DPM uses for SharePoint site recovery.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-IntermediateSqlInstance

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

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-IsRecoveryDatabase

Indicates that the database is a recovery database.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IsRecoveryStorageGroup

Indicates that the recovery is a recovery storage group.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ItemLevelRecoveryType

Specifies the recovery type.

The acceptable values for this parameter are:

  • RecoveryFarm
  • UnattachedInstance
Type:SharepointRecoveryType
Accepted values:RecoveryFarm, UnattachedInstance
Position:Named
Default value:None
Required:False
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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-LogFileCopyLocation

Specifies the location where DPM copies log files.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MailboxDisplayName

Specifies a name that DPM displays on the mailbox.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MountDatabaseAfterRestore

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OverwriteType

Specifies the action that DPM takes when the file it is recovering already exists.

The acceptable values for this parameter are:

  • CreateCopy
  • Skip
  • Overwrite
Type:OverwriteType
Accepted values:Overwrite, NoOverwrite, CopyOnExist
Position:6
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-PrimaryDpmServer

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

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-RecoverToReplicaFromTape

Indicates whether recovery to the replica is from a tape.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RecoveryLocation

Specifies the location where DPM recovers data.

The acceptable values for this parameter are:

  • OriginalServer
  • CopyToFolder
  • OriginalServerWithDBRename
  • AlternateExchangeServer
  • ExchangeServerDatabase
Type:RecoveryLocation
Accepted values:OriginalServer, CopyToFolder, OriginalServerWithDBRename, AlternateExchangeServer, ExchangeServerDatabase, PrimaryDPMServer, DPMReplicaVolume, AlternateHyperVServer
Position:2
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-RecoveryType

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

Type:RecoveryType
Accepted values:Recover, Restore
Position:Named
Default value:None
Required:True
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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SANRecovery

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SharePoint

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

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-SharePointSite

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

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-SQL

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

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-StagingAreaPath

Specifies the path of the staging area.

Type:String
Position:2
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-StorageGroupName

Specifies the name of the storage group.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SystemProtectionDatasource

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

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-TargetLocation

Specifies the location where DPM stores the replica.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TargetServer

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.

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-TargetSiteUrl

Specifies the URL of the target where DPM recovers data.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Outputs

RecoveryOption