New-DPMRecoveryPoint

Creates a recovery point.

Syntax

New-DPMRecoveryPoint [-Datasource] <Datasource[]> [-AdhocJobsContext <AdhocJobsContext>]
 [-BackupType <BackupType>] [-Disk] [-JobStateChangedEventHandler <JobStateChangedEventHandler>]
 [-WithDataIntegrityCheck] [-Confirm] [-WhatIf] [<CommonParameters>]
New-DPMRecoveryPoint [-Datasource] <Datasource[]> [-AdhocJobsContext <AdhocJobsContext>] [-Disk]
 -DiskRecoveryPointOption <CreateDiskRecoveryPointOption>
 [-JobStateChangedEventHandler <JobStateChangedEventHandler>] [-WithDataIntegrityCheck] [-Confirm] [-WhatIf]
 [<CommonParameters>]
New-DPMRecoveryPoint [-Datasource] <Datasource[]> [-AdhocJobsContext <AdhocJobsContext>]
 [-JobStateChangedEventHandler <JobStateChangedEventHandler>] [-Online] [-Confirm] [-WhatIf]
 [<CommonParameters>]
New-DPMRecoveryPoint [-Datasource] <Datasource[]> [-AdhocJobsContext <AdhocJobsContext>]
 [-JobStateChangedEventHandler <JobStateChangedEventHandler>] -ProtectionType <ProtectionType> [-Tape]
 [-Confirm] [-WhatIf] [<CommonParameters>]

Description

The New-DPMRecoveryPoint cmdlet creates a recovery point for a data source. You can create a recovery point for short-term and long-term protection types.

Examples

Example 1: Create a recovery point and run a backup

PS C:\>$PGroup = Get-DPMProtectionGroup -DPMServerName "DPMServer02"
PS C:\> $PObjects = Get-DPMDatasource -ProtectionGroup $PGroup
PS C:\> New-DPMRecoveryPoint -Datasource $PObjects -Disk -BackupType ExpressFull

The first command gets the protection group on the DPM server named DPMServer02, and then stores the results in the $PGroup variable.

The second command gets the list of protected and unprotected data in the protection group stored in $PGroup. The command stores the results in the $PObjects variable.

The third command creates a recovery point for the data source stored in $PObjects, and performs an ExpressFull backup.

Example 2: Create a recovery point and synchronize with the data source

PS C:\>$PGroup = Get-DPMProtectionGroup -DPMServerName "DPMServer02"
PS C:\> $PObjects = Get-DPMDatasource -ProtectionGroup $PGroup
PS C:\> New-DPMRecoveryPoint -Datasource $PObjects -Disk -DiskRecoveryPointOption WithSynchronize

The first command gets the protection group on the DPM server named DPMServer02, and then stores the results in the $PGroup variable.

The second command gets the list of protected and unprotected data in the protection group stored in $PGroup. The command stores the results in the $PObjects variable.

The third command creates a recovery point for the data source stored in the $PObjects variable, and synchronizes the recovery point with the data source.

Example 3: Create a short-term recovery point on tape

PS C:\>$PGroup = Get-DPMProtectionGroup -DPMServerName "DPMServer02"
PS C:\> $PObjects = Get-DPMDatasource -ProtectionGroup $PGroup
PS C:\> New-DPMRecoveryPoint -Datasource $PObjects -Tape -ProtectionType ShortTerm

The first command gets the protection group on the DPM server named DPMServer02, and then stores the results in the $PGroup variable.

The second command gets the list of protected and unprotected data in the protection group stored in $PGroup. The command stores the results in the $PObjects variable.

The third command creates a recovery point on tape for the data source stored in $PObjects, and sets the protection type to short-term.

Parameters

-AdhocJobsContext

Specifies the context details of the ad hoc job. Do not use this parameter from the Windows PowerShell command line.

Type:AdhocJobsContext
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-BackupType

Specifies the type of backup.

The acceptable values for this parameter are:

- ExpressFull

  • Incremental

Type:BackupType
Parameter Sets:ExpressFull, Incremental
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Datasource

Specifies an array of data source objects for which this cmdlet creates recovery points. A data source can be a file system share or volume for the Windows operating system, Microsoft SQL Server database, Microsoft Exchange Server storage group, Microsoft SharePoint farm, Microsoft Virtual Machine, System Center 2016 - Data Protection Manager (DPM) database, or system state that is a member of a protection group.

Type:Datasource[]
Required:True
Position:1
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False
-Disk

Indicates that DPM creates the recovery point on a disk.

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

Specifies whether DPM creates a recovery point while it synchronizes, or whether DPM synchronizes only and does not create a recovery point.

The acceptable values for this parameter are:

- WithSynchronize

  • WithoutSynchronize
  • OnlySynchronize

Type:CreateDiskRecoveryPointOption
Parameter Sets:WithSynchronize, WithoutSynchronize, OnlySynchronize
Required:True
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-JobStateChangedEventHandler

Specifies an event handler for Job.StateChanged events. Use this parameter to build a graphical user interface based on cmdlets. Do not use this parameter in the DPM Management Shell.

Type:JobStateChangedEventHandler
Aliases:Handler
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Online

Specifies that DPM enables online protection.

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

Specifies a protection type.

Type:ProtectionType
Parameter Sets:ShortTerm, LongTerm
Required:True
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Tape

Indicates that the recovery point is on a tape.

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

Indicates that DPM performs a data integrity check during recovery.

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

Prompts you for confirmation before running the cmdlet.

Type:SwitchParameter
Aliases:cf
Required:False
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False
-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

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

Outputs

Job