Copy-VBRJob

Short Description

Clones existing jobs.

Platform: VMware, Hyper-V

Product Edition: Enterprise, Enterprise Plus, Veeam Universal License

Syntax

Copy-VBRJob [-Job] <CBackupJob[]> [-Name <String[]>] [-Description <String[]>]

[-Repository <CBackupRepository>] [<CommonParameters>]

Detailed Description

This cmdlet clones an existing job. You can use the cloned job, for example, as a template, as it retains all settings of the primary job.

You can run this cmdlet with backup, replication, tape and copy jobs.

Parameters

Parameters
Parameter	Description	Type	Required	Position	Accept Pipeline Input
Description	Specifies the description of the cloned job.	`String[]`	False	Named	False
Job	Specifies the array of jobs you want to clone. Accepts the `CBackupJob[]` object. To get this object, run the `Get-VBRJob` or `Get-VBRTapeJob` cmdlet.	`CBackupJob[]`	True	0	True (ByPropertyName, ByValue)
Name	Specifies the name you want to assign to the cloned job. The maximum length is 50 symbols. If you exceed the length limit, the cloned job name will be cropped to 50 symbols. Default: the name of the primary job with the `_clone<clone sequence number>` suffix.	`String[]`	False	Named	False
Repository	Specifies the backup repository that will be used by the cloned job as a target. Accepts the `CBackupRepository` object. To get this object, run the `Get-VBRBackupRepository` cmdlet.	`CBackupRepository`	False	Named	False

<CommonParameters>

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

Examples

Copy-VBRJob Example 1. Cloning Specific Jobs [Using Pipeline]

This example shows how to clone the DHCP Replica Job and DHCP Backup Job jobs.

Get-VBRJob -Name "DHCP Replica Job", "DHCP Backup Job" | Copy-VBRJob

Perform the following steps:

Copy-VBRJob Example 2. Cloning Jobs [Using Variable]

This example shows how to clone the job represented by the $job variable.

$job = Get-VBRJob -Name "Backup Job"

Copy-VBRJob -Job $job

Perform the following steps:

Run the Get-VBRJob cmdlet. Specify the Name parameter value. Save the result to the $job variable.
Run the Copy-VBRJob cmdlet. Set the $job variable as the Job parameter value.