Get-VBRArchiveTierSyncInterval

Short Description

Returns a time period of checkpoints in the archive tier that are available for synchronization.

Syntax

This cmdlet provides the following parameter sets:

AllParameterSets (Default)

Get-VBRArchiveTierSyncInterval -Repository <VBRScaleOutBackupRepository> [<CommonParameters>]
Job

Get-VBRArchiveTierSyncInterval -Repository <VBRScaleOutBackupRepository> -Job <VBRJob> [<CommonParameters>]
Backup

Get-VBRArchiveTierSyncInterval -Repository <VBRScaleOutBackupRepository> -Backup <CBackup> [<CommonParameters>]
TenantBackupId

Get-VBRArchiveTierSyncInterval -Repository <VBRScaleOutBackupRepository> -TenantBackupId <Guid> [<CommonParameters>]
TenantId

Get-VBRArchiveTierSyncInterval -Repository <VBRScaleOutBackupRepository> -TenantId <Guid> [<CommonParameters>]

Detailed Description

This cmdlet returns a time period of checkpoints in the archive tier that are available for synchronization. You may want to run this cmdlet before you synchronize the state of backup chains with the state of backup chains on the archive tier for the specific period of time. When you synchronize the state of backup chains with state of backup chains on the archive tier, the state of backup chains on the capacity tier does not change.

Run the Sync-VBRSOBREntityState cmdlet to synchronize the state of the backup chains.

Important

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

Parameters

Parameters
Parameter	Description	Type	Required	Position	Accept Pipeline Input
Backup	Specifies a backup. The cmdlet will return a time period that contains checkpoints on the archive tier for this backup.	`CBackup`	True	Named	True (ByPropertyName)
Job	Specifies a job. The cmdlet will return a time period that contains checkpoints on the archive tier for this job.	`VBRJob`	True	Named	True (ByPropertyName)
Repository	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 archive tier.	`VBRScaleOutBackupRepository`	True	Named	True (ByPropertyName, ByValue)
TenantBackupId	Specifies an ID of the cloud tenant backup. The cmdlet will return a time period that contains checkpoints on the archive tier for this backup.	`Guid`	True	Named	False
TenantId	Specifies an ID of the cloud tenant. The cmdlet will return a time period that contains checkpoints on the archive tier created by this tenant.	`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 VBRArchiveTierSyncInterval object contains details on a time period of checkpoints in archive tier that are available for synchronization.

Examples

Get-VBRArchiveTierSyncInterval Example 1. Getting Time Period for all Checkpoints Available on Archive Tier

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

$repository = Get-VBRBackupRepository -ScaleOut

Get-VBRArchiveTierSyncInterval -Repository $repository

StartDateUtc EndDateUtc

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

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

Perform the following steps:

Run the Get-VBRBackupRepository cmdlet. Provide the ScaleOut parameter value. Save the result to the $repository variable.
Run the Get-VBRArchiveTierSyncInterval 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-VBRArchiveTierSyncInterval Example 2. Getting Time Period of Checkpoints for Specific Job

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

$repository = Get-VBRBackupRepository -ScaleOut

$job = Get-VBRJob -Name "Backup05"

Get-VBRArchiveTierSyncInterval -Repository $repository -Job $job

StartDateUtc EndDateUtc

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

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

Perform the following steps:

Run the Get-VBRBackupRepository cmdlet. Provide the ScaleOut parameter value. Save the result to the $repository variable.
Run the Get-VBRJob cmdlet. Specify the Name parameter value. Save the result to the $job variable.
Run the Get-VBRArchiveTierSyncInterval 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-VBRArchiveTierSyncInterval 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 archive tier that you can synchronize for the Report05 backup.

$repository = Get-VBRBackupRepository -ScaleOut

$backup = Get-VBRBackup -Name "Report05"

Get-VBRArchiveTierSyncInterval -Repository $repository -Backup $backup

StartDateUtc EndDateUtc

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

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

Perform the following steps:

Run the Get-VBRBackupRepository cmdlet. Provide the ScaleOut parameter value. Save the result to the $repository variable.
Run the Get-VBRBackup cmdlet. Specify the Name parameter value. Save the result to the $backup variable.
Run the Get-VBRArchiveTierSyncInterval 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.