New-DPMRecoveryPoint
Creates a recovery point.
Syntax
FileSystemOnDisk
New-DPMRecoveryPoint
[-Datasource] <Datasource[]>
-DiskRecoveryPointOption <CreateDiskRecoveryPointOption>
[-Disk]
[-WithDataIntegrityCheck]
[-JobStateChangedEventHandler <JobStateChangedEventHandler>]
[-AdhocJobsContext <AdhocJobsContext>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ApplicationOnDisk
New-DPMRecoveryPoint
[-Datasource] <Datasource[]>
[-Disk]
[-WithDataIntegrityCheck]
[-BackupType <BackupType>]
[-JobStateChangedEventHandler <JobStateChangedEventHandler>]
[-AdhocJobsContext <AdhocJobsContext>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
TapeData
New-DPMRecoveryPoint
[-Datasource] <Datasource[]>
-ProtectionType <ProtectionType>
[-Tape]
[-JobStateChangedEventHandler <JobStateChangedEventHandler>]
[-AdhocJobsContext <AdhocJobsContext>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
LongTermCloud
New-DPMRecoveryPoint
[-Datasource] <Datasource[]>
[-Online]
[-JobStateChangedEventHandler <JobStateChangedEventHandler>]
[-AdhocJobsContext <AdhocJobsContext>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
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.
Examples
Example 1: Create a recovery point and run a 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 $PObjects, and performs an ExpressFull backup.
Example 2: Create a recovery point and synchronize 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 for the data source stored in the $PObjects variable, and synchronizes the recovery point with the data source.
Example 3: Create a short-term recovery point on tape
PS C:\>$PGroup = Get-DPMProtectionGroup -DPMServerName "DPMServer02"
PS C:\> $PObjects = Get-DPMDatasource -ProtectionGroup $PGroup
PS C:\> New-DPMRecoveryPoint -Datasource $PObjects -Tape -ProtectionType ShortTerm
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.
Parameters
-AdhocJobsContext
Specifies the context details of the ad hoc job. Do not use this parameter from the Windows PowerShell command line.
Parameter properties
| Type: | AdhocJobsContext |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-BackupType
Specifies the type of backup.
The acceptable values for this parameter are:
- ExpressFull
- Incremental
Parameter properties
| Type: | BackupType |
| Default value: | None |
| Accepted values: | ExpressFull, Incremental |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
ApplicationOnDisk
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-Confirm
Prompts you for confirmation before running the cmdlet.
Parameter properties
| Type: | SwitchParameter |
| Default value: | False |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | cf |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-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, System Center 2019 - Data Protection Manager (DPM) database, or system state that is a member of a protection group.
Parameter properties
| Type: | Datasource[] |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | 1 |
| Mandatory: | True |
| Value from pipeline: | True |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-Disk
Indicates that DPM creates the recovery point on a disk.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
FileSystemOnDisk
| Position: | Named |
| Mandatory: | True |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
ApplicationOnDisk
| Position: | Named |
| Mandatory: | True |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-DiskRecoveryPointOption
Specifies whether DPM creates a recovery point while it synchronizes, or whether DPM synchronizes only and does not create a recovery point.
The acceptable values for this parameter are:
- WithSynchronize
- WithoutSynchronize
- OnlySynchronize
Parameter properties
| Type: | CreateDiskRecoveryPointOption |
| Default value: | None |
| Accepted values: | WithSynchronize, WithoutSynchronize, OnlySynchronize |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
FileSystemOnDisk
| Position: | Named |
| Mandatory: | True |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-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.
Parameter properties
| Type: | JobStateChangedEventHandler |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | Handler |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-Online
Specifies that DPM enables online protection.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
LongTermCloud
| Position: | Named |
| Mandatory: | True |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-ProtectionType
Specifies a protection type.
Parameter properties
| Type: | ProtectionType |
| Default value: | None |
| Accepted values: | ShortTerm, LongTerm |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
TapeData
| Position: | Named |
| Mandatory: | True |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-Tape
Indicates that the recovery point is on a tape.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
TapeData
| Position: | Named |
| Mandatory: | True |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-WhatIf
Shows what would happen if the cmdlet runs. The cmdlet is not run.
Parameter properties
| Type: | SwitchParameter |
| Default value: | False |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | wi |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-WithDataIntegrityCheck
Indicates that DPM performs a data integrity check during recovery.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
FileSystemOnDisk
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
ApplicationOnDisk
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.