Get-VBRUnstructuredBackupFLRItemVersion

Short Description

Returns versions of objects backed-up by file backup jobs or object storage backup jobs.

Note

This cmdlet is available starting from Veeam Backup & Replication 12.1 (build 12.1.0.2131).

Applies to

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

Syntax

This cmdlet provides parameter sets that allow you to:

  • Get the latest version of objects located in the archive repository.

Get-VBRUnstructuredBackupFLRItemVersion -Item <VBRUnstructuredBackupFLRItem> [-LatestArchivedVersion] [<CommonParameters>]

  • Get versions of objects by the object modification date.

Get-VBRUnstructuredBackupFLRItemVersion -Item <VBRUnstructuredBackupFLRItem>> [-ModificationDate <DateTime>] [<CommonParameters>]

  • Get versions of objects by the object version ID.

Get-VBRUnstructuredBackupFLRItemVersion -Item <VBRUnstructuredBackupFLRItem>> [-VersionId <UInt64>] [<CommonParameters>]

  • Get versions of objects by the object version ID.

Get-VBRUnstructuredBackupFLRItemVersion -Item <VBRUnstructuredBackupFLRItem> [-LatestArchivedVersion]

Detailed Description

This cmdlet returns versions of objects backed-up by file backup jobs or object storage backup jobs.

Important

This cmdlet runs only with file-level restore sessions that are created to restore all versions of backups on file shares or object storage. Run the Start-VBRUnstructuredBackupFLRSession cmdlet to start file-level restore sessions.

Parameters

Parameter

Description

Type

Required

Position

Accept Pipeline Input

Item

Specifies an object. The cmdlet will return versions of this object.

Accepts the VBRUnstructuredBackupFLRItem object. To get this object, run the Get-VBRUnstructuredBackupFLRItem cmdlet.

True

Named

False

ModificationDate

Specifies the date when the object was modified. The cmdlet will return versions of objects that were modified on the specified date.

DateTime

False

Named

False

VersionId

Specifies a version ID of the object. The cmdlet will return objects with the specified version ID.

Uint64

False

Named

False

LatestArchivedVersion

Defines that the cmdlet will return the latest version of the object located in the archive repository.

SwitchParameter

False

Named

False

<CommonParameters>

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

Output Object

The cmdlet returns the VBRUnstructuredBackupFLRItemVersion objects that contain details on versions of objects backed-up by file backup jobs or object storage backup jobs.

Examples

Get-VBRUnstructuredBackupFLRItemVersionExample 1. Getting all Versions of Object

This example shows how to get all versions of an object backed-up by a file backup job.

$session = Start-VBRUnstructuredBackupFLRSession

$object = Get-VBRUnstructuredBackupFLRItem -Session $session

Get-VBRUnstructuredBackupFLRItemVersion -Item $object

Perform the following steps:

  1. Run the Start-VBRUnstructuredBackupFLRSession  cmdlet. Save the result to the $session variable.
  2. Run the Get-VBRUnstructuredBackupFLRItem cmdlet. Set the $session variable as the Session parameter value. Save the result to the $object variable.
  3. Run the Get-VBRUnstructuredBackupFLRItemVersion cmdlet. Set the $object variable as the Item parameter value.

Get-VBRUnstructuredBackupFLRItemVersionExample 2. Getting Versions of Objects by Modification Date

This example shows how to get versions of an object by the object modification date. Veeam Backup & Replication will return objects that have been modified on 9/9/2019.

$session = Start-VBRUnstructuredBackupFLRSession

$object = Get-VBRUnstructuredBackupFLRItem -Session $session

Get-VBRUnstructuredBackupFLRItemVersion -Item $object -ModificationDate "9/9/2019"

Perform the following steps:

  1. Run the Start-VBRUnstructuredBackupFLRSession  cmdlet. Save the result to the $session variable.
  2. Run the Get-VBRUnstructuredBackupFLRItem cmdlet. Set the $session variable as the Session parameter value. Save the result to the $object variable.
  3. Run the Get-VBRUnstructuredBackupFLRItemVersion cmdlet. Set the $object variable as the Item parameter value. Specify the ModificationDate parameter value.

Get-VBRUnstructuredBackupFLRItemVersionExample 3. Getting Versions of Objects by Version ID

This example shows how to get a version of an object by the object version ID. Veeam Backup & Replication will return an object with the 9 version ID.

$session = Start-VBRUnstructuredBackupFLRSession

$object = Get-VBRUnstructuredBackupFLRItem -Session $session

Get-VBRUnstructuredBackupFLRItemVersion -Item $object -VersionId 9

Perform the following steps:

  1. Run the Start-VBRUnstructuredBackupFLRSession  cmdlet. Save the result to the $session variable.
  2. Run the Get-VBRUnstructuredBackupFLRItem cmdlet. Set the $session variable as the Session parameter value. Save the result to the $object variable.
  3. Run the Get-VBRUnstructuredBackupFLRItemVersion cmdlet. Set the $object variable as the Item parameter value. Specify the VersionId parameter value.

Related Commands