Sync-VBRObjectToTapeJob

Short Description

Starts an active full for a selected GFS object to tape job.

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

Syntax

This cmdlet provides the following parameter sets:

  • Weekly

    Sync-VBRObjectToTapeJob -Job <VBRObjectToTapeJob> [-Weekly] [-Wait] [<CommonParameters>]

  • Monthly

    Sync-VBRObjectToTapeJob -Job <VBRObjectToTapeJob> [-Monthly] [-Wait] [<CommonParameters>]

  • Quarterly

    Sync-VBRObjectToTapeJob -Job <VBRObjectToTapeJob> [-Quarterly] [-Wait] [<CommonParameters>]

  • Yearly

    Sync-VBRObjectToTapeJob -Job <VBRObjectToTapeJob> [-Yearly] [-Wait] [<CommonParameters>]

Detailed Description

This cmdlet starts an active full for a selected backup period of a GFS object to tape job. The job must be targeted to a GFS media pool.

Parameters

Parameters

Parameter

Description

Type

Required

Position

Accept Pipeline Input

Job

Specifies the GFS object to tape job for which you want to create an active full.

Accepts the VBRObjectToTapeJob object. To create this object, run the Get-VBRTapeJobReturns tape jobs. cmdlet.

VBRObjectToTapeJob

True

Named

True (ByValue)

Monthly

Defines that the job will create a monthly full.

SwitchParameter

True

Named

False

Quarterly

Defines that the job will create a quarterly full.

SwitchParameter

True

Named

False

Wait

Defines that the command waits for the process to complete before accepting more input.

SwitchParameter

False

Named

False

Weekly

Defines that the job will create a weekly full.

SwitchParameter

True

Named

False

Yearly

Defines that the job will create a yearly full.

SwitchParameter

True

Named

False

<CommonParameters>

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see Microsoft Docs.

Examples

Starting Weekly Active Full Backup for GFS Object to Tape Job

This example shows how to start an active weekly full backup for the Sydney Container to Tape GFS object to tape job.

$job = Get-VBRTapeJob -Name "Sydney Container to Tape"

Sync-VBRObjectToTapeJob -Job $job -Weekly

Perform the following steps:

  1. Run the Get-VBRTapeJobReturns tape jobs. cmdlet. Specify the Name parameter value. Save the result to the $job variable.
  2. Run the Sync-VBRObjectToTapeJob cmdlet. Set the $job variable as the Job parameter value. Provide the Weekly parameter.

Get-VBRTapeJobReturns tape jobs.

Page updated 2026-08-19

Page content applies to build 13.1.1.18