New-DPMRecoveryPoint

Creates a recovery point.

Syntax

New-DPMRecoveryPoint
   [-Datasource] <Datasource[]>
   [-Disk]
   [-WithDataIntegrityCheck]
   -DiskRecoveryPointOption <CreateDiskRecoveryPointOption>
   [-JobStateChangedEventHandler <JobStateChangedEventHandler>]
   [-AdhocJobsContext <AdhocJobsContext>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-DPMRecoveryPoint
   [-Datasource] <Datasource[]>
   [-Disk]
   [-WithDataIntegrityCheck]
   [-BackupType <BackupType>]
   [-JobStateChangedEventHandler <JobStateChangedEventHandler>]
   [-AdhocJobsContext <AdhocJobsContext>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-DPMRecoveryPoint
   [-Datasource] <Datasource[]>
   [-Tape]
   -ProtectionType <ProtectionType>
   [-JobStateChangedEventHandler <JobStateChangedEventHandler>]
   [-AdhocJobsContext <AdhocJobsContext>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-DPMRecoveryPoint
   [-Datasource] <Datasource[]>
   [-Online]
   [-JobStateChangedEventHandler <JobStateChangedEventHandler>]
   [-AdhocJobsContext <AdhocJobsContext>]
   [-WhatIf]
   [-Confirm]
   [<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
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
Accepted values:ExpressFull, Incremental
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
Position:Named
Default value:False
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 2019 - Data Protection Manager (DPM) database, or system state that is a member of a protection group.

Type:Datasource[]
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
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
Accepted values:WithSynchronize, WithoutSynchronize, OnlySynchronize
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
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Online

Specifies that DPM enables online protection.

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

Specifies a protection type.

Type:ProtectionType
Accepted values:ShortTerm, LongTerm
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
Position:Named
Default value:None
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
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False
-WithDataIntegrityCheck

Indicates that DPM performs a data integrity check during recovery.

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

Outputs

Job