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