Get-VBRRestorePoint
Returns restore points.
Product Edition: Standard, Enterprise, Enterprise Plus, Veeam Universal License
This cmdlet provides parameter sets that allow you to:
Get-VBRRestorePoint [-Backup <CBackup[]>] [-Name <String[]>] [-ObjectId <Guid[]>] [<CommonParameters>] |
- Get restore points by their ID.
Get-VBRRestorePoint -Id <Guid[]> [<CommonParameters>] |
This cmdlet returns restore points created by Veeam Backup & Replication.
Restore points created by replication jobs are represented as snapshots.
Restore points created by backup jobs are represented as full and increment backup files.
Important |
To get a list of restore points for a Veeam Agent job, you must provide the asterisks sign for the Name parameter value: Name "AgentJob*". Otherwise, the Get-VBRRestorePoint cmdlet will not return any restore points for the Veeam Agent job. |
Parameter | Description | Type | Required | Position | Accept Pipeline Input |
|---|
Id | Specifies an array of IDs of backed-up VMs. The cmdlet will return restore points of these VMs. | Guid[] | True | Named | True (ByPropertyName) |
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 | 0 | True (ByValue,
ByProperty
Name) |
Name | Specifies an array of VM names. The cmdlet will return restore points of these VMs. Note: For Cloud Director and CDP replica you must specify a vApp. | String[] | False | Named | False |
ObjectId | Specifies an array of IDs of backed-up hosts and VMs. The cmdlet will return restore points of these hosts and VMs. | Guid[] | False | Named | True (
ByProperty
Name) |
<CommonParameters>
This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see Microsoft Docs.
The cmdlet returns the COib object that contains information on restore points created by Veeam Backup & Replication.
This command looks for all restore points of all VMs registered in the database. |
This command looks for the 2ee79fec-9aa8-4058-a147-ff6b76ef2924 restore point. Get-VBRRestorePoint -Id 2ee79fec-9aa8-4058-a147-ff6b76ef2924 |
|
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.
|
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. Set the $replica variable as the Backup parameter value.
|
This example shows how to get all restore points of Windows-based machines backed up by the WinBackup Veeam Agent job. $winbackup = Get-VBRBackup -Name "WinBackup" Get-VBRRestorePoint -Backup $winbackup |
Perform the following steps: - Run the Get-VBRBackup cmdlet. Specify the Name parameter value. Save the result to the $winbackup variable.
- Run the Get-VBRRestorePoint cmdlet. Set the $winbackup variable as the Backup parameter value.
|
This example shows how to look 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. Specify the First parameter value.
|
This example shows how to return 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-VBRReplica 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 as the Property parameter value. Provide the Descending parameter.
- Pipe the cmdlet output to the Select cmdlet. Specify the First parameter value.
|
Related Commands
Example 1. Getting all Restore Points