---
title: "Sync-VBRSOBREntityState"
description: "Synchronizes the state of backup chains on performance extents with the state of data on capacity and archive extents of a scale-out backup repositories."
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/sync-vbrsobrentitystate.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Backup Infrastructure > Scale-Out Backup Repositories > Immutability > Sync-VBRSOBREntityState"
dateModified: "2026-08-20"
---

# Sync-VBRSOBREntityState

## Short Description
Synchronizes the state of backup chains on performance extents with the state of data on capacity and archive extents of a scale-out backup repositories.

## Syntax

This cmdlet provides the following parameter sets:

<ul class="syntax-sets">
  <li>
    <p><code>Job</code></p>

```
Sync-VBRSOBREntityState -Job <VBRJob> -PointInTime <DateTime> [-ArchiveTier] [-RunAsync] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>Repository</code></p>

```
Sync-VBRSOBREntityState -Repository <VBRScaleOutBackupRepository> -PointInTime <DateTime> [-ArchiveTier]
 [-RunAsync] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>TenantId</code></p>

```
Sync-VBRSOBREntityState -Repository <VBRScaleOutBackupRepository> -TenantId <Guid> -PointInTime <DateTime>
 [-ArchiveTier] [-RunAsync] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>Backup</code></p>

```
Sync-VBRSOBREntityState -Backup <CBackup> -PointInTime <DateTime> [-ArchiveTier] [-RunAsync] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>TenantBackupId</code></p>

```
Sync-VBRSOBREntityState -TenantBackupId <Guid> -PointInTime <DateTime> [-ArchiveTier] [-RunAsync] [<CommonParameters>]
```
  </li>
</ul>

## Detailed Description
This cmdlet synchronizes the state of backup chains on performance extents of scale-out backup repositories with the state of data on capacity and archive extents of scale-out backup repositories for the specific period of time.

Run the [`Get-VBRCapacityTierSyncInterval`](get-vbrcapacitytiersyncinterval.md) cmdlet to get details on the period of time when checkpoints in the capacity tier are available for synchronization.

Run the [`Get-VBRArchiveTierSyncInterval`](get-vbrarchivetiersyncinterval.md) cmdlet to get details on the period of time when checkpoints in the archive tier are available for synchronization.

::: important

Use this cmdlet only with object storage that support the immutability option.

:::

## Parameters

<table style="width:100%;" class="Blue_Table">
      <tr style="vertical-align:top">
        <th style="width:20%;">
          <p>Parameter</p>
        </th>
        <th style="width:20%;">
          <p>Description</p>
        </th>
        <th style="width:20%;">
          <p>Type</p>
        </th>
        <th style="width:10%;">
          <p>Required</p>
        </th>
        <th style="width:10%;">
          <p>Position</p>
        </th>
        <th style="width:10%;">
          <p>Accept Pipeline Input</p>
        </th>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">ArchiveTier</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will synchronize the state of backup chains on performance extents with the state of backup chains located in the archive tier.</p><p>If you do not provide this parameter, the cmdlet will synchronizes the state of backup chains on performance extents with the state of backup chains on the capacity extent.</p><p>Default: <code>False</code>.</p>
        </td>
        <td style="width:10%;">
          <p><code>SwitchParameter</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Backup</span></p>
        </td>
        <td>
          <p>Specifies a backup. The cmdlet will synchronize data for a specified period in time from the capacity extent for these backups.</p><p>Accepts the <code>CBackup</code> object. To get this object, run the <a href="get-vbrbackup.md"><code>Get-VBRBackup</code></a> cmdlet</p>
        </td>
        <td style="width:10%;">
          <p><code>CBackup</code></p>
        </td>
        <td style="width:10%;">
          <p>True</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Job</span></p>
        </td>
        <td>
          <p>Specifies a job. The cmdlet will synchronize data for a specified period in time from the capacity extent for this job.</p><p>Accepts the <code>VBRJob</code> object. To get this object, run the <a href="get-vbrjob.md"><code>Get-VBRJob</code></a> cmdlet</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbrjob.md"><code>VBRJob</code></a></p>
        </td>
        <td style="width:10%;">
          <p>True</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">PointInTime</span></p>
        </td>
        <td>
          <p>Specifies a period in time to which you want to restore data. The cmdlet will synchronize data from the capacity extent to the specified period.</p>
        </td>
        <td style="width:10%;">
          <p><code>DateTime</code></p>
        </td>
        <td style="width:10%;">
          <p>True</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Repository</span></p>
        </td>
        <td>
          <p>Specifies a scale-out backup repository. The cmdlet will synchronize data for a specified period in time from the capacity extent for this repository.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbrscaleoutbackuprepository.md"><code>VBRScaleOutBackupRepository</code></a></p>
        </td>
        <td style="width:10%;">
          <p>True</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">RunAsync</span></p>
        </td>
        <td>
          <p>Defines that the command returns immediately without waiting for the task to complete.</p>
        </td>
        <td style="width:10%;">
          <p><code>SwitchParameter</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">TenantBackupId</span></p>
        </td>
        <td>
          <p>Specifies a ID of the tenant backup.</p>
        </td>
        <td style="width:10%;">
          <p><code>Guid</code></p>
        </td>
        <td style="width:10%;">
          <p>True</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">TenantId</span></p>
        </td>
        <td>
          <p>Specifies s tenant ID.</p>
        </td>
        <td style="width:10%;">
          <p><code>Guid</code></p>
        </td>
        <td style="width:10%;">
          <p>True</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
    </table>

`<CommonParameters>`

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see [ Microsoft Docs](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_commonparameters?view=powershell-7).

## Output Object
[`VBRSession`](vbrsession.md)

## Examples

::: example
### Example 1. Synchronizing Data for Specific Job

This example shows how to synchronize data that is stored in the capacity extent 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`](get-vbrjob.md) cmdlet. Specify the `Name` parameter value. 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`.

:::

::: example
### Example 2. Synchronizing Data for Scale-Out Backup Repository

This example shows how to synchronize data that is stored in the capacity extent 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`](get-vbrbackuprepository.md) cmdlet. Provide the `ScaleOut` parameter value. Save the result to the `$repository` variable.
2. Run the [`Get-VBRCapacityTierSyncInterval`](get-vbrcapacitytiersyncinterval.md) 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`.

:::

::: example
### Example 3. Synchronizing Data for Specific Backup

This example shows how to synchronize data that is stored on extents for the specified backup.

```
$backup = Get-VBRBackup -Name "BackupJob05"
$date = Get-Date -Year 2020 -Month 2 -Day 2 -Hour 0 -Minute 0 -Second 0
Sync-VBRSOBREntityState -Backup $backup -PointInTime $date
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`](get-vbrbackup.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$job` variable.
2. Run the [`Get-Date`](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.utility/get-date?view=powershell-7.1) cmdlet. Specify the `Year`, `Month`, `Day`, `Hour`, `Minute` and `Second` parameter values. Save the result to the `$date` variable.
3. Run the `Sync-VBRSOBREntityState` cmdlet. Set the `$backup` variable as the `Backup` parameter value. Set the `$date` variable as 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

- [`Get-VBRJob`](get-vbrjob.md)
- [`Get-VBRBackupRepository`](get-vbrbackuprepository.md)
- [`Get-VBRBackup`](get-vbrbackup.md)
- [`Get-VBRCapacityTierSyncInterval`](get-vbrcapacitytiersyncinterval.md)
- [`Get-Date`](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.utility/get-date?view=powershell-7.1)