Get-VBRObjectStorageRepositorySyncInterval

Short Description

Returns a time period available for synchronization for checkpoints located in object storage repositories.

Applies to

Platform: VMware, Hyper-V

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

Syntax

This cmdlet provides parameter sets that allow you to:

  • Get a time period of all checkpoints that are located in object storage repositories.

Get-VBRObjectStorageRepositorySyncInterval -Repository <VBRObjectStorageRepository>  [<CommonParameters>]

  • Get a time period of checkpoints that are created by the specific job.

Get-VBRObjectStorageRepositorySyncInterval -Repository <VBRObjectStorageRepository> -Job <VBRJob>  [<CommonParameters>]

  • Get a time period of checkpoints that are added to the specific backup.

Get-VBRObjectStorageRepositorySyncInterval -Repository <VBRObjectStorageRepository> -Backup <CBackup>  [<CommonParameters>]

  • Get a time period of checkpoints that are added to the specific cloud tenant backup.

Get-VBRObjectStorageRepositorySyncInterval -Repository <VBRObjectStorageRepository> -TenantBackupId <Guid>  [<CommonParameters>]

  • Get a time period of checkpoints that are created by the specific cloud tenant.

Get-VBRObjectStorageRepositorySyncInterval -Repository <VBRObjectStorageRepository> -TenantId <Guid>  [<CommonParameters>]

Detailed Description

This cmdlet returns a time period available for synchronization of checkpoints located in object storage repositories. You can get details on the time period when checkpoints in object storage are available for synchronization.

You may want to run this cmdlet before you roll back checkpoints in object storage repositories to the previous state.

Run the Sync-VBRObjectStorageRepositoryEntityState to synchronize the state of the backup chains.

Important

Consider the following:

  • Use this cmdlet only with object storage that support the immutability option.
  • Do not use this cmdlet with object storage repositories added as a performance tier of a scale-out backup repository.

Parameters

Parameter

Description

Type

Required

Position

Accept Pipeline Input

Repository

Specifies an object storage repository. The cmdlet will return time periods for checkpoints located in this repository.

Accepts the VBRObjectStorageRepository object. To create this object, run the Get-VBRObjectStorageRepository cmdlet.

True

Named

True (ByValue)

Job

Specifies a job. The cmdlet will return a time period for checkpoints created by this job.

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

True

Named

False

Backup

Specifies a backup. The cmdlet will return a time period for checkpoints added to this backup.

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

True

Named

False

TenantBackupId

Specifies an ID of the cloud tenant backup. The cmdlet will return a time period for checkpoints added to this backup.

Note: This parameter is available starting from Veeam Backup & Replication 12.1 (build 12.1.0.2131).

Guid

True

Named

False

TenantId

Specifies an ID of the cloud tenant. The cmdlet will return a time period for checkpoints created by this tenant.

Note: This parameter is available starting from Veeam Backup & Replication 12.1 (build 12.1.0.2131).

Guid

True

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 VBRObjectStorageRepositorySyncInterval object that contains a time period available for synchronization of checkpoints located in object storage repositories.

Examples

Get-VBRObjectStorageRepositorySyncIntervalExample 1. Getting Time Period for all Checkpoints Available in Object Storage Repositories

This example shows how to get a time period for all checkpoints located in the Amazon S3 object storage repository.

$repository = Get-VBRObjectStorageRepository -Name "Amazon S3"

Get-VBRObjectStorageRepositorySyncInterval -Repository $repository

 

StartDateUtc                                                EndDateUtc

------------                                                ----------

2/20/2020 1:54:26 PM                                        2/20/2020 1:54:26 PM

Perform the following steps:

  1. Run the Get-VBRObjectStorageRepository cmdlet. Specify the Name parameter value. Save the result to the $repository variable.
  2. Run the Get-VBRObjectStorageRepositorySyncInterval cmdlet. Set the $repository variable as the Repository parameter value.

The cmdlet output will contain the following details on the time period for the checkpoints: StartDateUtc and EndDateUtc.

Get-VBRObjectStorageRepositorySyncIntervalExample 2. Getting Time Period of Checkpoints for Specific Job

This example shows how to get a time period that contains checkpoints located in the Amazon S3 created by the Backup05 job.

$repository = Get-VBRObjectStorageRepository -Name "Amazon S3"

$job = Get-VBRJob -Name "Backup05"

Get-VBRObjectStorageRepositorySyncInterval -Repository $repository -Job $job

 

StartDateUtc                                                EndDateUtc

------------                                                ----------

2/20/2020 1:54:26 PM                                        2/20/2020 1:54:26 PM

Perform the following steps:

  1. Run the Get-VBRObjectStorageRepository cmdlet. Specify the Name parameter value. Save the result to the $repository variable.
  2. Run the Get-VBRJob cmdlet. Specify the Name parameter value. Save the result to the $job variable.
  3. Run the Get-VBRObjectStorageRepositorySyncInterval cmdlet. Set the $repository variable as the Repository parameter value. Set the $job variable as the Job parameter value.

The cmdlet output will contain the following details on the time period for the checkpoints: StartDateUtc and EndDateUtc.

Get-VBRObjectStorageRepositorySyncIntervalExample 3. Getting Time Period of Checkpoints for Specific Backup

This example shows how to get a time period that contains details on checkpoints located in the Amazon S3 object storage repository available in the Report05 backup.

$repository = Get-VBRObjectStorageRepository -Name "Amazon S3"

$backup = Get-VBRBackup -Name "Report05"

Get-VBRObjectStorageRepositorySyncInterval -Repository $repository -Backup $backup

 

StartDateUtc                                                EndDateUtc

------------                                                ----------

2/20/2020 1:54:26 PM                                        2/20/2020 1:54:26 PM

Perform the following steps:

  1. Run the Get-VBRObjectStorageRepository cmdlet. Specify the Name parameter value. Save the result to the $repository variable.
  2. Run the Get-VBRBackup cmdlet. Specify the Name parameter value. Save the result to the $backup variable.
  3. Run the Get-VBRObjectStorageRepositorySyncInterval cmdlet. Set the $repository variable as the Repository parameter value. Set the $backup variable as the Backup parameter value.

The cmdlet output will contain the following details on the time period for the checkpoints: StartDateUtc and EndDateUtc.

Related Commands