This is an archive version of the document. To get the most up-to-date information, see the current version.

Add-VBRvCloudBackupCopyJob

In this article

Short Description

Creates a vCloud backup copy job.

Applies to

Platform: VMware

Product Edition: Standard, Enterprise, Enterprise Plus

Syntax

Add-VBRvCloudBackupCopyJob [-Name <String>] [-Entity <IItem[]>] [-Backup <CBackup[]>] [-BackupJob <CBackupJob[]>][-Repository <CBackupRepository>] -SourceAccelerator <CWanAccelerator> -TargetAccelerator <CWanAccelerator> [-Description <String>] [-WarningAction <ActionPreference>] [-WarningVariable <String>] [<CommonParameters>]

-OR-

Add-VBRvCloudBackupCopyJob [-Name <String>] [-Entity <IItem[]>] [-Backup <CBackup[]>] [-BackupJob <CBackupJob[]>][-Repository <CBackupRepository>] -DirectOperation [-Description <String>] [-WarningAction <ActionPreference>][-WarningVariable <String>] [<CommonParameters>]

Related Commands

Get-VBRBackup

Get-VBRJob

Get-VBRBackupRepository

Get-VBRWANAccelerator

Detailed Description

This cmdlet creates a new vCloud backup copy job. The vCloud backup copy job uses a cloud repository as the target.

To add the VMs for the backup copy job, you can add VMs, backups or backup jobs. Veeam will use this data to copy the backups of the needed VM.

You can transfer data in the following ways:

Using WAN accelerators. This mode is recommended for off-site backups.

To create and run a backup copy job using WAN accelerators you need to have source and target WAN accelerators created. Run Add-VBRWANAccelerator to create a WAN accelerator. WAN optimization is available only in Veeam Backup & Replication Enterprise Plus Edition.

Directly. With this method, the job sends the data directly to the target backup repository without performing data deduplication. This mode is recommended for on-site backups, or off-site backups using fast connections.

Use an appropriate parameter set for each way.

Note that the backup copy job is created in disabled state. Run Enable-VBRJob to start the job running on the defined schedule.

Parameters

Parameter	Description	Required	Position	Accept Pipeline Input	Accept Wildcard Characters
Name	Specifies the name you want to assign to the backup copy job.	False	Named	False	False
Entity	Specifies the VM(s) you want to copy. You can assign multiple VMs to this object.	False	Named	True (ByValue, ByProperty Name)	False
Backup	Specifies the existing backup from where the VMs to copy are derived. You can assign multiple backups to this object.	False	Named	False	False
BackupJob	Specifies the existing backup job from where the VMs to copy are derived. You can assign multiple backup jobs to this object.	False	Named	False	False
Repository	Specifies the target backup repository to where you want to copy the VM data. If not set, Veeam Backup & Replication will use the default backup repository.	False	Named	False	False
Source Accelerator	Specifies the WAN accelerator on the source side. If you select the mode using WAN accelerators, the -DirectOperation parameter should be omitted.	True	Named	False	False
Target Accelerator	Specifies the WAN accelerator on the target side. If you select the mode using WAN accelerators, the -DirectOperation parameter should be omitted.	True	Named	False	False
Description	Specifies the description of the backup copy job. If not set, Veeam Backup & Replication will enter date and time of creation by default.	False	Named	False	False
Direct Operation	Enables the direst operation method sending the data directly to the target backup repository without performing data deduplication. If you select the direct operation mode, the -TargetAccelerator and -SourceAccelerator parameters should be omitted.	False	Named	False	False

This cmdlet supports Microsoft PowerShell common parameters. For more information about common parameters, see http://go.microsoft.com/fwlink/p/?LinkID=113216.

Example 1

This command creates a backup copy job named "vCloud CopyJob1" with the following parameters:

The source and target WAN accelerators are obtained with Get-VBRWANAccelerator and assigned to $wansource and $wantarget variables accordingly beforehand,
The VMs to copy are obtained with Find-VBRvCloudEntity and assigned to the $vms variable beforehand,
The repository to where the VM data will be copied is obtained with Get-VBRBackupRepository and assigned to the $repository variable beforehand.

PS C:\PS> Add-VBRvCloudBackupCopyJob -SourceAccelerator $wansource -TargetAccelerator $wantarget -Name CopyJob1 -Entity $vms -Repository $repository

Example 2

This command creates a direct backup copy job with the following parameters:

The name of the job is "DC CopyJob",
The backup job named "DC Backup" with the VMs to be copied is obtained with Get-VBRBackup and piped down,
The -Repository parameter is not set to copy the VMs to the default backup repository.

PS C:\PS> Get-VBRBackup -Name "DC Backup" | Add-VBRvCloudBackupCopyJob -DirectOperation -Name "DC CopyJob"