Get-VBOCopyJob

Short Description

Returns backup copy jobs.

Syntax

This cmdlet provides the following parameter sets:

ByIdParameterSet

Get-VBOCopyJob -Id <Guid> [<CommonParameters>]
AllParameterSet

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 query a backup copy job by ID or associated backup job and backup repository.

Parameters

Parameters
Parameter	Description	Type	Required	Position	Accept Pipeline Input
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.	`VBOJob`	False	Named	False
Id	Specifies an ID of the backup copy job. The cmdlet will return the backup copy job with this ID.	`Guid`	True	Named	False
Repository	Specifies an object storage repository. Veeam Backup for Microsoft 365 uses this object storage repository as a target for backup copy jobs. Accepts the `VBORepository` object. To get this object, run the `Get-VBORepository` cmdlet.	`VBORepository`	False	Named	False

<CommonParameters>

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see the About Common Parameters section of Microsoft Learn.

Output Object

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

Examples

Get-VBOCopyJob Example 1: Getting Backup Copy Job by ID

This command returns a backup copy job by ID.

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

Get-VBOCopyJob Example 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:

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

Get-VBOCopyJob Example 3: Getting Backup Copy Job by Backup Repository

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

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

Get-VBOCopyJob -Repository $repository

Perform the following steps:

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