This is an archive version of the document. To get the most up-to-date information, see the current version.

Get-VBRRestorePoint

Short Description

Returns restore points.

Applies to

Product Edition: Standard, Enterprise, Enterprise Plus

Syntax

Get-VBRRestorePoint [[-Backup] <CBackup[]>] [-Name <String[]>] [-WarningAction <ActionPreference>] [-WarningVariable <String>] [<CommonParameters>]

Detailed Description

This cmdlet returns restore points stored in the Veeam Backup & Replication database.

With this cmdlet, you can get restore points created by all types of jobs: backup jobs, backup copy jobs, replication jobs, vCD jobs and Veeam Agent for Microsoft Windows backup jobs.

You can get a list of restore points of all VMs managed by Veeam Backup & Replication, or get the restore points for a specific backup or for a specific VM.

Restore points created by replication jobs are represented as snapshots.

Restore points created by backup jobs are represented as full and increment backup files.

Parameters

Parameter	Description	Type	Required	Position	Accept Pipeline Input
Backup	Specifies the array of backups. The cmdlet will return restore points of these backups.	Accepts the CBackup[] object. To get this object, run the Get-VBRBackup cmdlet.	False	1	True (ByValue, ByProperty Name)
Name	Specifies the array of VM names. The cmdlet will return restore points of these VMs.	String[]	False	Named	False

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see the About CommonParameters section of Microsoft Docs.

Examples

Get-VBRRestorePoint Example 1. Getting all Restore Points

This command looks for all restore points of all VMs registered in the database.

Get-VBRRestorePoint

Get-VBRRestorePoint Example 2. Getting Restore Points Created by Backup Job

This example shows how to get all restore points of the MSExchange02 VM that is backed up by the MSExchange backup job.

$backup = Get-VBRBackup -Name "MSExchange"

Get-VBRRestorePoint -Name *MSExchange02* -Backup $backup

Perform the following steps:

Run the Get-VBRBackup cmdlet. Specify the Name parameter value. Save the result to the $backup variable.
Run the Get-VBRRestorePoint cmdlet. Specify the Name parameter value. Set the $backup variable as the Backup parameter value.

Get-VBRRestorePoint Example 3. Getting Restore Points Created by Replication Job

This example shows how to get all restore points of VMs that are replicated by the DC Replica replication job.

$replica = Get-VBRReplica -Name "DC Replica"

Get-VBRRestorePoint -Backup $replica

Perform the following steps:

Run the Get-VBRReplica cmdlet. Specify the Name parameter value. Save the result to the $replica variable.
Run the Get-VBRRestorePoint cmdlet. Specify the Name parameter value. Set the $replica variable as the Backup parameter value.

Get-VBRRestorePoint Example 4. Getting Latest Restore Point Created by Backup Job [Using Pipeline]

This command looks for the latest restore point of VMs that are backed up by the MSExchange Backup backup job.

Get-VBRBackup -Name MSExchange Backup | Get-VBRRestorePoint -Name MSExchange02 | Sort-Object –Property CreationTime –Descending | Select-Object -First 1

Perform the following steps:

Run the Get-VBRBackup cmdlet. Specify the Name parameter value.
Pipe the cmdlet output to the Get-VBRRestorePoint cmdlet. Specify the Name parameter value.
Pipe the cmdlet output to the Sort-Object cmdlet. Set the CreationTime value for the Property parameter. Provide the Descending parameter.
Pipe the cmdlet output to the Select-Object cmdlet. Set the 1 number as the First parameter value.

Get-VBRRestorePoint Example 3. Getting Latest Restore Point Created by Replication Job [Using Pipeline]

This command returns the latest restore point of the MSExchange02 VM that is replicated by the Replica_Exchange replication job.

Get-VBRReplica -Name Replica_Exchange | Get-VBRRestorePoint -Name MSExchange02 | Sort-Object -Property CreationTime -Descending | Select -First 1

Perform the following steps:

Run the Get-VBRBackup cmdlet. Specify the Name parameter value.
Pipe the cmdlet output to the Get-VBRRestorePoint cmdlet. Specify the Name parameter value.
Pipe the cmdlet output to the Sort-Object cmdlet. Set the CreationTime value for the Property parameter. Provide the Descending parameter.
Pipe the cmdlet output to the Select-Object cmdlet. Set the 1 number as the First parameter value.

Related Commands