New-DPMRecoveryPoint
Creates a recovery point.
Syntax
New-DPMRecoveryPoint
[-Datasource] <Datasource[]>
[-Disk]
[-WithDataIntegrityCheck]
-DiskRecoveryPointOption <CreateDiskRecoveryPointOption>
[-JobStateChangedEventHandler <JobStateChangedEventHandler>]
[-AdhocJobsContext <AdhocJobsContext>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-DPMRecoveryPoint
[-Datasource] <Datasource[]>
[-Disk]
[-WithDataIntegrityCheck]
[-BackupType <BackupType>]
[-JobStateChangedEventHandler <JobStateChangedEventHandler>]
[-AdhocJobsContext <AdhocJobsContext>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-DPMRecoveryPoint
[-Datasource] <Datasource[]>
[-Tape]
-ProtectionType <ProtectionType>
[-JobStateChangedEventHandler <JobStateChangedEventHandler>]
[-AdhocJobsContext <AdhocJobsContext>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] 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 ExpressFullThe 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 WithSynchronizeThe 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 ShortTermThe 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.
| Type: | AdhocJobsContext |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-BackupType
Specifies the type of backup.
The acceptable values for this parameter are:
- ExpressFull
- Incremental
| Type: | BackupType |
| Accepted values: | ExpressFull, Incremental |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
Prompts you for confirmation before running the cmdlet.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | Datasource[] |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Disk
Indicates that DPM creates the recovery point on a disk.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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
| Type: | CreateDiskRecoveryPointOption |
| Accepted values: | WithSynchronize, WithoutSynchronize, OnlySynchronize |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | JobStateChangedEventHandler |
| Aliases: | Handler |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Online
Specifies that DPM enables online protection.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ProtectionType
Specifies a protection type.
| Type: | ProtectionType |
| Accepted values: | ShortTerm, LongTerm |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Tape
Indicates that the recovery point is on a tape.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
Shows what would happen if the cmdlet runs. The cmdlet is not run.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WithDataIntegrityCheck
Indicates that DPM performs a data integrity check during recovery.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Outputs
Job