---
title: "Get-VBRCapacityTierSyncInterval"
description: "This cmdlet returns a time period of checkpoints in capacity tier that are available for synchronization. You may want to run this cmdlet before you synchronize the state of the backup chains on performance tier with the state of the backup chains..."
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/get-vbrcapacitytiersyncinterval.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Backup Infrastructure > Scale-Out Backup Repositories > Immutability > Get-VBRCapacityTierSyncInterval"
dateModified: "2026-08-19"
---

# Get-VBRCapacityTierSyncInterval

## Short Description
Returns a time period of checkpoints in capacity tier that are available for synchronization.

## Syntax

This cmdlet provides the following parameter sets:

<ul class="syntax-sets">
  <li>
    <p><code>AllParameterSets (Default)</code></p>

```
Get-VBRCapacityTierSyncInterval -Repository <VBRScaleOutBackupRepository> [<CommonParameters>]
```
  </li>
  <li>
    <p><code>Job</code></p>

```
Get-VBRCapacityTierSyncInterval -Repository <VBRScaleOutBackupRepository> -Job <VBRJob> [<CommonParameters>]
```
  </li>
  <li>
    <p><code>Backup</code></p>

```
Get-VBRCapacityTierSyncInterval -Repository <VBRScaleOutBackupRepository> -Backup <CBackup> [<CommonParameters>]
```
  </li>
  <li>
    <p><code>TenantBackupId</code></p>

```
Get-VBRCapacityTierSyncInterval -Repository <VBRScaleOutBackupRepository> -TenantBackupId <Guid> [<CommonParameters>]
```
  </li>
  <li>
    <p><code>TenantId</code></p>

```
Get-VBRCapacityTierSyncInterval -Repository <VBRScaleOutBackupRepository> -TenantId <Guid> [<CommonParameters>]
```
  </li>
</ul>

## Detailed Description
This cmdlet returns a time period of checkpoints in capacity tier that are available for synchronization. You may want to run this cmdlet before you synchronize the state of the backup chains on performance tier with the state of the backup chains on capacity tier for the specific period of time.

Run the [`Sync-VBRSOBREntityState`](sync-vbrsobrentitystate.md) cmdlet to synchronize the state of the backup chains.

::: 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">Backup</span></p>
        </td>
        <td>
          <p>Specifies a backup. The cmdlet will return a time period that contains checkpoints on the capacity tier for this backup.</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>True (ByPropertyName)</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 return a time period that contains checkpoints on the capacity tier for this job.</p><p>Accepts the <code>VBR  Job</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>True (ByPropertyName)</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 return a time period that contains checkpoints that were moved from this scale-out backup repository but are still available on the capacity tier.</p><p>Accepts the <code>VBRScaleOutBackupRepository</code> object. To get this object, run the <a href="get-vbrbackuprepository.md"><code>Get-VBRBackupRepository</code></a> cmdlet.</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>True (ByPropertyName, ByValue)</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 an ID of the cloud tenant backup. The cmdlet will return a time period that contains checkpoints on the capacity tier for this 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 an ID of the cloud tenant. The cmdlet will return a time period that contains checkpoints on the capacity tier created by this tenant.</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
This cmdlet returns the `VBRCapacityTierSyncInterval` object that contains details on a time period of checkpoints in capacity tier that are available for synchronization

## Examples

::: example
### Example 1.  Getting Time Period for all Checkpoints Available on Capacity Tier

This example shows how to get a time period with contains checkpoints on capacity tier that are available for synchronization.

```
$repository = Get-VBRBackupRepository -ScaleOut
Get-VBRCapacityTierSyncInterval -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-VBRBackupRepository`](get-vbrbackuprepository.md) 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.

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

:::

::: example
### Example 2. Getting Time Period of Checkpoints for Specific Job

This example shows how to get a time period that contains checkpoints on capacity tier that you can synchronize for the `Backup05` job.

```
$repository = Get-VBRBackupRepository -ScaleOut
$job = Get-VBRJob -Name "Backup05"
Get-VBRCapacityTierSyncInterval -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-VBRBackupRepository`](get-vbrbackuprepository.md) cmdlet. Provide the `ScaleOut` parameter value. Save the result to the `$repository` variable.
2. Run the [`Get-VBRJob`](get-vbrjob.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$job` variable.
3. Run the `Get-VBRCapacityTierSyncInterval` 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`.

:::

::: example
### Example 3. Getting Time Period of Checkpoints for Specific Backup

This example shows how to get a time period that contains details on checkpoints on capacity tier that you can synchronize for the `Report05` backup.

```
$repository = Get-VBRBackupRepository -ScaleOut
$backup = Get-VBRBackup -Name "Report05"
Get-VBRCapacityTierSyncInterval -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-VBRBackupRepository`](get-vbrbackuprepository.md) cmdlet. Provide the `ScaleOut` parameter value. Save the result to the `$repository` variable.
2. Run the [`Get-VBRBackup`](get-vbrbackup.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$backup` variable.
3. Run the `Get-VBRCapacityTierSyncInterval` 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

- [`Get-VBRJob`](get-vbrjob.md)
- [`Get-VBRBackupRepository`](get-vbrbackuprepository.md)
- [`Get-VBRBackup`](get-vbrbackup.md)