New-DPMRecoveryPoint

New-DPMRecoveryPoint

Creates a recovery point.

Syntax

Parameter Set: ApplicationOnDisk
New-DPMRecoveryPoint [-Datasource] <Datasource[]> -Disk [-AdhocJobsContext <AdhocJobsContext> ] [-BackupType <DbEnums+BackupType> {ExpressFull | Incremental} ] [-JobStateChangedEventHandler <JobStateChangedEventHandler> ] [-WithDataIntegrityCheck] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: FileSystemOnDisk
New-DPMRecoveryPoint [-Datasource] <Datasource[]> -Disk -DiskRecoveryPointOption <DbEnums+CreateDiskRecoveryPointOption> {WithSynchronize | WithoutSynchronize | OnlySynchronize} [-AdhocJobsContext <AdhocJobsContext> ] [-JobStateChangedEventHandler <JobStateChangedEventHandler> ] [-WithDataIntegrityCheck] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: LongTermCloud
New-DPMRecoveryPoint [-Datasource] <Datasource[]> -Online [-AdhocJobsContext <AdhocJobsContext> ] [-JobStateChangedEventHandler <JobStateChangedEventHandler> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: TapeData
New-DPMRecoveryPoint [-Datasource] <Datasource[]> -ProtectionType <DbEnums+ProtectionType> {ShortTerm | LongTerm} -Tape [-AdhocJobsContext <AdhocJobsContext> ] [-JobStateChangedEventHandler <JobStateChangedEventHandler> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Detailed 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.

Parameters

-AdhocJobsContext<AdhocJobsContext>

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

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-BackupType<DbEnums+BackupType>

Specifies the type of backup. Valid values are:

-- ExpressFull
-- Incremental

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Datasource<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, DPM database, or system state that is a member of a protection group.

Aliases

none

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.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-DiskRecoveryPointOption<DbEnums+CreateDiskRecoveryPointOption>

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

-- WithSynchronize
-- WithoutSynchronize
-- OnlySynchronize

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-JobStateChangedEventHandler<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.

Aliases

Handler

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Online

Specifies that DPM enables online protection.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-ProtectionType<DbEnums+ProtectionType>

Specifies a protection type.

Aliases

none

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.

Aliases

none

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.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Confirm

Prompts you for confirmation before running the cmdlet.

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.

Required?

false

Position?

named

Default Value

false

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.

  • Job

Examples

Example 1: Create a recovery point and run a backup

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.

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

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

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.

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

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

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.

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

Get-DPMProtectionGroup

Get-DPMDatasource

Get-DPMRecoveryPoint

Remove-DPMRecoveryPoint

Get-DPMRecoveryPointLocation