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

Sync-VBRSOBREntityState

Short Description

Synchronizes the backup chains state on extents of scale-out backup repositories with the backup chains state in object storage for the specific period of time.

Applies to Amazon S3, S3 Compatible

Product Edition: Standard, Enterprise, Enterprise Plus

Syntax

This cmdlet provides parameter sets that allow you to:

  • Synchronizes state of data on extents of scale-out backup repositories with state of data in object storage for the specified job.

Sync-VBRSOBREntityState -Job <VBRJob> -PointInTime <datetime> [-RunAsync]  [<CommonParameters>]

  • Synchronizes state of data on extents for the specified scale-out backup repository.

Sync-VBRSOBREntityState -Repository <VBRScaleOutBackupRepository> -PointInTime <datetime> [-RunAsync] [<CommonParameters>]

  • Synchronizes state of data on extents for the specified backup.

Sync-VBRSOBREntityState -Backup <CBackup> -PointInTime <datetime> [-RunAsync]  [<CommonParameters>]

Detailed Description

This cmdlet synchronizes the state of backup chains on extents of scale-out backup repositories with the state of a backup chains in object storage for the specific period of time.

Run the Get-VBRCapacityTierSyncInterval cmdlet to get details on the period of time when checkpoints in object storage are available for synchronization.

Sync-VBRSOBREntityState Important!

This cmdlet applies only for object storage that support the Immutability option.

Parameters

Parameter

Description

Type

Required

Position

Accept Pipeline Input

Job

Specifies a job. The cmdlet will synchronize data for a specified period in time from object storage for this job.

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

True

Note: This parameter is required when you want to synchronize data for a specific job.

Named

False

Repository

Specifies a scale-out backup repository. The cmdlet will synchronize data for a specified period in time from object storage for this repository.

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

True

Named

False

Backup

Specifies a backup. The cmdlet will synchronize data for a specified period in time from object storage for these backups.

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

True

Note: This parameter is required when you want to synchronize data for a specific backup.

Named

False

PointInTime

Specifies a period in time to which you want to restore data. The cmdlet will synchronize data from object storage to the specified period.

DateTime

True

Named

False

RunAsync

Defines that the command returns immediately without waiting for the task to complete.

SwitchParameter

False

Named

False

<CommonParameters>

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

Output Object

VBRSession

Examples

Sync-VBRSOBREntityStateExample 1. Synchronizing Data for Specific Job

This example shows how to synchronize data that is stored in object storage for the BackupJob05 job.

$job = Get-VBRJob -Name "BackupJob05"

Sync-VBRSOBREntityState -Job $job -PointInTime "2/20/2020 1:54:26 PM"

 

CreationTime : 2/20/2020 6:26:59 AM

EndTime      : 2/20/2020 6:28:24 AM

JobId        : 876cddc2-2879-484e-9680-7b5b2261fa30

Result       : Success

State        : Stopped

Id           : ae8fccee-78e5-4e73-a98d-0069fd61032f

Perform the following steps:

  1. Run the Get-VBRJob cmdlet. Save the result to the $job variable.
  2. Run the Sync-VBRSOBREntityState cmdlet. Set the $job variable as the Job parameter value. Specify the PointInTime parameter value.

The cmdlet output will contain the following details on the time period for the checkpoints: CreationTime, EndTime, JobId, Result, State and Id.

Sync-VBRSOBREntityStateExample 2. Synchronizing Data for Scale-Out Backup Repository

This example shows how to synchronize data that is stored in object storage for the specified scale-out backup repository.

$repository = Get-VBRBackupRepository -ScaleOut

Get-VBRCapacityTierSyncInterval -Repository $repository

StartDateUtc                                                EndDateUtc

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

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

Sync-VBRSOBREntityState -Repository $repository -PointInTime "2/20/2020 1:54:26 PM"

 

CreationTime : 2/20/2020 6:26:59 AM

EndTime      : 2/20/2020 6:28:24 AM

JobId        : 23e57bae-a759-42a2-a47e-06219ac410df

Result       : Success

State        : Stopped

Id           : 10957ec5-adc9-418c-a708-2f24ba11d40e

Perform the following steps:

  1. Run the Get-VBRBackupRepository cmdlet. Provide the ScaleOut parameter value. Save the result to the $repository variable.
  2. Run the Get-VBRCapacityTierSyncInterval cmdlet. Set the $repository variable as the Repository parameter value.
  3. Run the Sync-VBRSOBREntityState cmdlet. Set the $repository variable as the Repository parameter value. Specify the PointInTime parameter value.

The cmdlet output will contain the following details on the time period for the checkpoints: CreationTime, EndTime, JobId, Result, State and Id.

Sync-VBRSOBREntityStateExample 3. Synchronizing Data for Specific Backup

This example shows how to synchronize data that is stored in object storage for the specified backup.

$backup = Get-VBRBackup -Name "BackupJob05"

Sync-VBRSOBREntityState -Backup $backup -PointInTime "2/20/2020 1:54:26 PM"

 

CreationTime : 2/20/2020 6:26:59 AM

EndTime      : 2/20/2020 6:28:24 AM

JobId        : a1116d74-6d0e-4449-813e-08d094d355c1

Result       : Success

State        : Stopped

Id           : 3cb43bcc-86fc-48a2-b08b-c79d4bfb7183

Perform the following steps:

  1. Run the Get-VBRBackup cmdlet. Save the result to the $job variable.
  2. Run the Sync-VBRSOBREntityState cmdlet. Set the $backup variable as the Backup parameter value. Specify the PointInTime parameter value.

The cmdlet output will contain the following details on the time period for the checkpoints: CreationTime, EndTime, JobId, Result, State and Id.

Related Commands