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