Get-VBOCopyJob

Short Description

Returns backup copy jobs.

Syntax

This cmdlet provides parameter sets that allow you to:

  • Get all backup copy jobs configured in Veeam Backup for Microsoft 365.

Get-VBOCopyJob  [<CommonParameters>]

  • Get a backup copy job by the backup copy job ID.

Get-VBOCopyJob -Id <guid>  [<CommonParameters>]

  • Get backup copy job by the associated backup job or backup repository.

Get-VBOCopyJob [-BackupJob <VBOJob>] [-Repository <VBORepository>]  [<CommonParameters>]

Detailed Description

This cmdlet returns backup copy jobs configured in Veeam Backup for Microsoft 365. You can get all backup copy jobs or look for a backup copy job by ID or associated backup job and backup repository.

Parameters

Parameter

Description

Type

Required

Position

Accept Pipeline Input

Accept Wildcard Characters

Id

Specifies an ID of a backup copy job. The cmdlet will return the backup copy job with this ID.

Guid

True

Named

False

False

BackupJob

Specifies a backup job for which you have created a backup copy job.

Accepts the VBOJob object.

To get this object, run the Get-VBOJob cmdlet.

False

Named

False

False

Repository

Specifies a backup repository extended with an archive object storage. Veeam Backup for Microsoft 365 uses this backup repository as a target for backup copy jobs.

Accepts the VBORepository object.

To get this object, run the Get-VBORepository cmdlet.

False

Named

False

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

The cmdlet returns the VBOCopyJob object that contains settings for a backup copy job.

Examples

Get-VBOCopyJobExample 1. Getting Backup Copy Job by ID

This example shows how to get a backup copy job by ID:

Get-VBOCopyJob -Id 8b6b539e-15cc-4ed6-bd1d-b8c7c918f413

Get-VBOCopyJobExample 2. Getting Backup Copy Job by Backup Job

This example shows how to get a backup copy job created for the backup job with the name ABC Backup.

$job = Get-VBOJob -Name "ABC Backup"

Get-VBOCopyJob -BackupJob $job

Perform the following steps:

  1. Run the Get-VBOJob cmdlet. Specify the Name parameter value. Save the result to the $job variable.
  2. Run the Get-VBOCopyJob cmdlet. Set the $job variable as the BackupJob parameter value.

Get-VBOCopyJobExample 3. Getting Backup Copy Job by Backup Repository

This example shows how to get backup copy jobs that copy backed-up data to the specified backup repository.

$repository = Get-VBORepository -Name "Azure Archive repository"

Get-VBOCopyJob -Repository $repository

Perform the following steps:

  1. Run the Get-VBORepository cmdlet. Specify the Name parameter value. Save the result to the $repository variable.
  2. Run the Get-VBOCopyJob cmdlet. Set the $repository variable as the Repository parameter value.

Related Commands