New-RecoveryPoint

New-RecoveryPoint

Creates a new recovery point for the data source.

Syntax

New-RecoveryPoint [-Datasource] <Datasource> -ProtectionType <ProtectionType> -Tape <Media> [-JobStateChangedEventHandler <JobStateChangedEventHandler>] [<CommonParameters>]


New-RecoveryPoint [-Datasource] <Datasource> -Disk <SwitchParameter> -DiskRecoveryPointOption <CreateDiskRecoveryPointOption> [-JobStateChangedEventHandler <JobStateChangedEventHandler>] [-WithDataIntegrityCheck <SwitchParameter>] [<CommonParameters>]


New-RecoveryPoint [-Datasource] <Datasource> -Disk <SwitchParameter> [-BackupType <BackupType>] [-JobStateChangedEventHandler <JobStateChangedEventHandler>] [-WithDataIntegrityCheck <SwitchParameter>] [<CommonParameters>]


New-RecoveryPoint [-Datasource] <Datasource> -Online <SwitchParameter> [-JobStateChangedEventHandler <JobStateChangedEventHandler>] [<CommonParameters>]

Detailed Description

The New-RecoveryPoint cmdlets creates a new recovery point for the data source.

The valid values for ProtectionType are ShortTerm and LongTerm.

Parameters

-Datasource

A Windows file system share or volume, Microsoft SQL Server database, Microsoft Exchange storage group, Microsoft SharePoint farm, Microsoft Virtual Machine, DPM database, or system state that is a member of a protection group.

Attributes

Name Value

Required?

true

Accept wildcard characters?

false

Accept Pipeline Input?

true (ByValue)

Position?

0

-Disk

Indicates that the operation must be performed on a disk.

Attributes

Name Value

Required?

true

Accept wildcard characters?

false

Accept Pipeline Input?

false

Position?

named

-DiskRecoveryPointOption

Indicates whether a recovery point should be created while synchronizing, or whether only synchronization should occur. The valid values are WithSynchronize, WithoutSynchronize, and OnlySynchronize.

Attributes

Name Value

Required?

true

Accept wildcard characters?

false

Accept Pipeline Input?

false

Position?

named

-Online

With Add-ProtectableObject: Indicates that the protectable object must be also protected with DPM Online.
With New-RecoveryPoint: Indicates that the recovery point must be created on DPM Online.
With Remove-DatasourceReplica: Indicates that data retained on DPM Online must be deleted.
With Remove-ChildDatasource: Indicates that the protectable object is removed from protection on DPM Online.

Attributes

Name Value

Required?

true

Accept wildcard characters?

false

Accept Pipeline Input?

false

Position?

named

-ProtectionType

Indicates the type of protection.

Attributes

Name Value

Required?

true

Accept wildcard characters?

false

Accept Pipeline Input?

false

Position?

named

-Tape

Indicates a tape object.

Attributes

Name Value

Required?

true

Accept wildcard characters?

false

Accept Pipeline Input?

false

Position?

named

-BackupType

Indicates the type of backup. The valid values are ExpressFull and Incremental.

Attributes

Name Value

Required?

false

Accept wildcard characters?

false

Accept Pipeline Input?

false

Position?

named

-JobStateChangedEventHandler

The JobStateChangedEventHandler is used along with the -Async parameter so that the user can be informed of the status of the operation. This is useful when building a GUI using cmdlets. It is not used when working with the DPM Management Shell.

Attributes

Name Value

Required?

false

Accept wildcard characters?

false

Accept Pipeline Input?

false

Position?

named

-WithDataIntegrityCheck

Indicates that data integrity check must be done during recovery.

Attributes

Name Value

Required?

false

Accept wildcard characters?

false

Accept Pipeline Input?

false

Position?

named

-CommonParameter

This cmdlet supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, and OutVariable. For more information, see about_CommonParameters.

Input and Return Types

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

Notes

  • For more information, type "Get-Help New-RecoveryPoint -detailed".
    For technical information, type "Get-Help New-RecoveryPoint -full".

    Additionally, any updated information about the cmdlet will be available at http://go.microsoft.com/fwlink/?LinkId=95130.

Examples

EXAMPLE 1

$pg = Get-ProtectionGroup -DPMServerName TestingServer 
$ds = Get-Datasource -ProtectionGroup $pg 
New-RecoveryPoint -Datasource $ds -Disk -BackupType expressfull

This command runs an Expressfull backup and creates a recovery point.

EXAMPLE 2

$pg = Get-ProtectionGroup -DPMServerName TestingServer 
$ds = Get-Datasource -ProtectionGroup $pg 
New-RecoveryPoint -Datasource $ds -Disk -DiskRecoveryPointOption withsynchronize

This command synchronizes and then creates a new recovery point for the datasource on disk.

EXAMPLE 3

$pg = Get-ProtectionGroup -DPMServerName TestingServer 
$ds = Get-Datasource -ProtectionGroup $pg 
New-RecoveryPoint -Datasource $ds -Tape -ProtectionType ShortTerm

This command creates a new recovery point for the data source on a tape with type set to short-term.