Get-VBRUnstructuredBackupRestorePoint

Short Description

Returns restore points created by file backup jobs and object storage backup jobs.

Product Edition: Standard, Enterprise, Enterprise Plus, Veeam Universal License

Syntax

This cmdlet provides the following parameter sets:

AllParameterSets (Default)

Get-VBRUnstructuredBackupRestorePoint [<CommonParameters>]
Id

Get-VBRUnstructuredBackupRestorePoint -Id <Guid[]> [<CommonParameters>]
NasBackup

Get-VBRUnstructuredBackupRestorePoint [-Server <VBRUnstructuredServer[]>] -Backup <VBRUnstructuredBackup[]> [<CommonParameters>]

Detailed Description

This cmdlet returns restore points created by file backup jobs file backup jobs and object storage backup jobs.

Parameters

Parameters
Parameter	Description	Type	Required	Position	Accept Pipeline Input
Backup	Specifies an array of backup files created by file backup jobs and object storage backup jobs. The cmdlet will return restore points that are available for these backup files. Accepts the `VBRUnstructuredBackup[]` object. To get this object, run the `Get-VBRUnstructuredBackup` cmdlet.	`VBRUnstructuredBackup[]`	True	Named	True (ByPropertyName, ByValue)
Id	Specifies an array of IDs of restore points. The cmdlet will return restore points with this IDs.	`Guid[]`	True	Named	False
Server	Specifies an array of file shares and object storage. The cmdlet will return backup files that are located on these file shares and object storage. Accepts the `VBRUnstructuredServer[]` object. To get this object, run the `Get-VBRUnstructuredServer` cmdlet.	`VBRUnstructuredServer[]`	False	Named	True (ByPropertyName)

<CommonParameters>

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see Microsoft Docs.

Output Object

The cmdlet returns the VBRUnstructuredBackupRestorePoint object that contains settings of restore points created by file backup jobs file backup jobs and object storage backup jobs.

Examples

Get-VBRUnstructuredBackupRestorePoint Example 1. Getting Restore Point Created by Object Storage Job by ID

This command returns the 51e4eced-3fce-465b-b516-f24cb5a068a4 restore point created by object storage job.

Get-VBRUnstructuredBackupRestorePoint -ID "51e4eced-3fce-465b-b516-f24cb5a068a4"

Get-VBRUnstructuredBackupRestorePoint Example 2. Getting Restore Point From Specific File Share

This example shows how to get restore points of the NFS Backup backup file. The restore points are located on the \\WinSRV2049\Documents file share.

$backupfile = Get-VBRUnstructuredBackup -Name "NFS Backup"

$server = Get-VBRUnstructuredServer -Name "\\WinSRV2049\Documents"

Get-VBRUnstructuredBackupRestorePoint -Server $server -Backup $backupfile

Perform the following steps:

Run the Get-VBRUnstructuredBackup cmdlet. Specify the Name parameter value. Save the result to the $backupfile variable.
Run the Get-VBRUnstructuredServer cmdlet. Specify the Name parameter value. Save the result to the $server variable.
Run the Get-VBRUnstructuredBackupRestorePoint cmdlet. Set the $server variable as the Server parameter value. Set the $backupfile variable as the Backup parameter value.

Get-VBRUnstructuredBackupRestorePoint Example 3. Getting Latest Restore Point Created by File Backup job

This command gets the latest restore point from an array of restore points.

$restorepoint = Get-VBRUnstructuredBackupRestorePoint | Sort-Object -Property CreationTime | Select-Object -Last 1

Perform the following steps:

Run the Get-VBRUnstructuredBackupRestorePoint cmdlet. Save the result to the $restorepoint variable.
Pipe the cmdlet output to the Sort-Object cmdlet. Set the CreationTime value as the Property parameter. Provide the Descending parameter.
Run the Select-Object cmdlet. Set the 1 value for the Last parameter.