New-DPMRecoveryPoint
Creates a recovery point.
Parameter Set: ApplicationOnDisk
New-DPMRecoveryPoint [-Datasource] <Datasource[]> -Disk [-AdhocJobsContext <AdhocJobsContext> ] [-BackupType <DbEnums+BackupType> {ExpressFull | Incremental} ] [-JobStateChangedEventHandler <JobStateChangedEventHandler> ] [-WithDataIntegrityCheck] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: FileSystemOnDisk
New-DPMRecoveryPoint [-Datasource] <Datasource[]> -Disk -DiskRecoveryPointOption <DbEnums+CreateDiskRecoveryPointOption> {WithSynchronize | WithoutSynchronize | OnlySynchronize} [-AdhocJobsContext <AdhocJobsContext> ] [-JobStateChangedEventHandler <JobStateChangedEventHandler> ] [-WithDataIntegrityCheck] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: LongTermCloud
New-DPMRecoveryPoint [-Datasource] <Datasource[]> -Online [-AdhocJobsContext <AdhocJobsContext> ] [-JobStateChangedEventHandler <JobStateChangedEventHandler> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: TapeData
New-DPMRecoveryPoint [-Datasource] <Datasource[]> -ProtectionType <DbEnums+ProtectionType> {ShortTerm | LongTerm} -Tape [-AdhocJobsContext <AdhocJobsContext> ] [-JobStateChangedEventHandler <JobStateChangedEventHandler> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
The New-DPMRecoveryPoint cmdlet creates a recovery point for a data source. You can create a recovery point for short-term and long-term protection types.
Specifies the context details of the ad hoc job. Do not use this parameter from the Windows PowerShell command line.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
Specifies the type of backup. Valid values are:
-- ExpressFull
-- Incremental
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
Specifies an array of data source objects for which this cmdlet creates recovery points. A data source can be a file system share or volume for the Windows operating system, Microsoft SQL Server database, Microsoft Exchange Server storage group, Microsoft SharePoint farm, Microsoft Virtual Machine, DPM database, or system state that is a member of a protection group.
Aliases |
none |
Required? |
true |
Position? |
1 |
Default Value |
none |
Accept Pipeline Input? |
True (ByValue) |
Accept Wildcard Characters? |
false |
Indicates that DPM creates the recovery point on a disk.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
Specifies whether DPM creates a recovery point while it synchronizes, or whether DPM synchronizes only and does not create a recovery point. Valid values are:
-- WithSynchronize
-- WithoutSynchronize
-- OnlySynchronize
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
Specifies an event handler for Job.StateChanged events. Use this parameter to build a graphical user interface based on cmdlets. Do not use this parameter in the DPM Management Shell.
Aliases |
Handler |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
Specifies that DPM enables online protection.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
Specifies a protection type.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
Indicates that the recovery point is on a tape.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
Indicates that DPM performs a data integrity check during recovery.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
Prompts you for confirmation before running the cmdlet.
Required? |
false |
Position? |
named |
Default Value |
false |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
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 |
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).
The input type is the type of the objects that you can pipe to the cmdlet.
The output type is the type of the objects that the cmdlet emits.
- Job
The first command gets the protection group on the DPM server named DPMServer02, and then 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 $PObjects variable.
The third command creates a recovery point for the data source stored in $PObjects, and performs an ExpressFull backup.
PS C:\> $PGroup = Get-DPMProtectionGroup -DPMServerName "DPMServer02"
PS C:\> $PObjects = Get-DPMDatasource -ProtectionGroup $PGroup
PS C:\> New-DPMRecoveryPoint -Datasource $PObjects -Disk -BackupType ExpressFull
The first command gets the protection group on the DPM server named DPMServer02, and then 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 $PObjects variable.
The third command creates a recovery point for the data source stored in the $PObjects variable, and synchronizes the recovery point with the data source.
PS C:\> $PGroup = Get-DPMProtectionGroup -DPMServerName "DPMServer02"
PS C:\> $PObjects = Get-DPMDatasource -ProtectionGroup $PGroup
PS C:\> New-DPMRecoveryPoint -Datasource $PObjects -Disk -DiskRecoveryPointOption WithSynchronize
The first command gets the protection group on the DPM server named DPMServer02, and then 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 $PObjects variable.
The third command creates a recovery point on tape for the data source stored in $PObjects, and sets the protection type to short-term.
PS C:\> $PGroup = Get-DPMProtectionGroup -DPMServerName "DPMServer02"
PS C:\> $PObjects = Get-DPMDatasource -ProtectionGroup $PGroup
PS C:\> New-DPMRecoveryPoint -Datasource $PObjects -Tape -ProtectionType ShortTerm