New-DPMRecoveryPoint
New-DPMRecoveryPoint
Creates a recovery point.
Syntax
Parameter Set: ApplicationOnDisk
New-DPMRecoveryPoint [-Datasource] <Datasource[]> -Disk [-AdhocJobsContext <AdhocJobsContext> ] [-BackupType <BackupType> ] [-JobStateChangedEventHandler <JobStateChangedEventHandler> ] [-WithDataIntegrityCheck] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: FileSystemOnDisk
New-DPMRecoveryPoint [-Datasource] <Datasource[]> -Disk -DiskRecoveryPointOption <CreateDiskRecoveryPointOption> [-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 <ProtectionType> -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 adhoc 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<BackupType>
Specifies the type of backup. The acceptable values for this parameter 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. Data source objects include the following:
-- Windows file system share or volume.
-- Microsoft SQL Server database.
-- Microsoft Exchange storage group.
-- Microsoft SharePoint farm.
-- Microsoft Virtual Machine.
-- DPM database.
-- A 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<CreateDiskRecoveryPointOption>
Specifies whether DPM creates a recovery point while synchronizing, or whether DPM synchronizes only and does not create a recovery point. The acceptable values for this parameter 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. You can use this parameter to update a GUI that runs in Windows PowerShell, but do not use it in the Windows PowerShell console.
Aliases |
none |
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<ProtectionType>
Specifies a protection type. The only valid value is Tape.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-Tape
Specifies that the recovery point is 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
Notes
- For more information, type "
Get-Help New-DPMRecoveryPoint -detailed
".
Examples
Example 1: Create a recovery point and run a backup
This example creates a recovery point for a data source and performs a backup.
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 creates a recovery point for the data source stored in the $Ds variable, and performs an expressfull backup.
PS C:\> $Pg = Get-DPMProtectionGroup -DPMServerName "DPMServer02"
PS C:\> $Ds = Get-DPMDatasource -ProtectionGroup $Pg
PS C:\> New-DPMRecoveryPoint -Datasource $Ds -Disk -BackupType expressfull
Example 2: Create a recovery point and synchronize with the data source
This example creates a recovery point for a data source and synchronizes the recovery point with the data source.
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 creates a recovery point for the data source stored in the $Ds variable, and synchronizes the recovery point with the data source.
PS C:\> $Pg = Get-DPMProtectionGroup -DPMServerName "DPMServer02"
PS C:\> $Ds = Get-DPMDatasource -ProtectionGroup $Pg
PS C:\> New-DPMRecoveryPoint -Datasource $Ds -Disk -DiskRecoveryPointOption withsynchronize
Example 3: Create a short-term recovery point on tape
This example creates a short-term recovery point on tape for a data source.
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 creates a recovery point on tape for the data source stored in the $Ds variable, and sets the protection type to short-term.
PS C:\> $Pg = Get-DPMProtectionGroup -DPMServerName "DPMServer02"
PS C:\> $Ds = Get-DPMDatasource -ProtectionGroup $Pg
PS C:\> New-DPMRecoveryPoint -Datasource $Ds -Tape -ProtectionType ShortTerm