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

Notes

  • For more information, type "Get-Help Remove-DPMRecoveryPoint -detailed".

Examples

Example 1: Remove a recovery point

The first command gets the protection group on the DPM server named DPMServer02 and store the results in the $Pg variable.

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

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

The fourth command removes the recovery point stored in the $Rp variable.

PS C:\> $Pg = Get-DPMProtectionGroup -DPMServerName "DPMServer02"

PS C:\> $Ds = Get-DPMDatasource -ProtectionGroup $Pg

PS C:\> $Rp = Get-DPMRecoveryPoint -Datasource $Ds

PS C:\> Remove-DPMRecoveryPoint -RecoveryPoint $Rp

Get-DPMProtectionGroup

Get-DPMDatasource

Get-DPMRecoveryPoint

New-DPMRecoveryPoint