Share via


Remove-DPMRecoveryPoint

Remove-DPMRecoveryPoint

Removes a recovery point from tape or disk.

Syntax

Parameter Set: Default
Remove-DPMRecoveryPoint [-RecoveryPoint] <RecoverySource> [-ForceDeletion] [-Confirm] [-WhatIf] [ <CommonParameters>]

Detailed Description

The Remove-DPMRecoveryPoint cmdlet removes a recovery point from tape or disk. If a recovery point exists in multiple locations, for example, on disk and tape, or two tapes, use the Get-DPMRecoveryPointLocation cmdlet to get the location of the recovery point.

Parameters

-ForceDeletion

Indicates that DPM prunes the data source regardless if it is currently running a backup job.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-RecoveryPoint<RecoverySource>

Specifies a recovery point that this cmdlet removes. To obtain a recovery point location object, use the Get-DPMRecoveryPoint cmdlet.

Aliases

none

Required?

true

Position?

1

Default Value

none

Accept Pipeline Input?

true (ByValue)

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.

Examples

Example 1: Remove a recovery point

The first command gets the protection group on the DPM server named DPMServer02, and 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 $PObject variable.

The third command gets the recovery point for the for the data source stored in $PObjects, and stores the results in the $RPoint variable.

The final command removes the recovery point stored in $RPoint.

PS C:\> $PGroup = Get-DPMProtectionGroup -DPMServerName "DPMServer02"
PS C:\> $PObjects = Get-DPMDatasource -ProtectionGroup $PGroup
PS C:\> $RPoint = Get-DPMRecoveryPoint -Datasource $PObjects
PS C:\> Remove-DPMRecoveryPoint -RecoveryPoint $RPoint

Get-DPMProtectionGroup

Get-DPMDatasource

Get-DPMRecoveryPoint

New-DPMRecoveryPoint