New-DPMRecoveryPoint
New-DPMRecoveryPoint
Creates a recovery point.
Syntax
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>]
Detailed Description
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.
Parameters
-AdhocJobsContext<AdhocJobsContext>
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 |
-BackupType<DbEnums+BackupType>
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 |
-Datasource<Datasource[]>
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 |
-Disk
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 |
-DiskRecoveryPointOption<DbEnums+CreateDiskRecoveryPointOption>
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 |
-JobStateChangedEventHandler<JobStateChangedEventHandler>
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 |
-Online
Specifies that DPM enables online protection.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-ProtectionType<DbEnums+ProtectionType>
Specifies a protection type.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-Tape
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 |
-WithDataIntegrityCheck
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 |
-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.
- Job
Examples
Example 1: Create a recovery point and run a backup
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
Example 2: Create a recovery point and synchronize with the data source
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
Example 3: Create a short-term recovery point on tape
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