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 https://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.