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

Add-VBREPBackupCopyJob

In this article

Short Description

Creates an Endpoint backup copy job.

Syntax

This cmdlet provides two parameter sets.

For direct data transfer:

Add-VBREPBackupCopyJob -Backup <CBackup[]> -DirectOperation [-Name <string>] [-Description <string>] [-Repository <CBackupRepository>] [<CommonParameters>]

For data transfer with WAN accelerators:

Add-VBREPBackupCopyJob -Backup <CBackup[]> -SourceAccelerator <CWanAccelerator> -TargetAccelerator <CWanAccelerator> [-Name <string>] [-Description <string>] [-Repository <CBackupRepository>] [<CommonParameters>]

Related Commands

Get-VBRBackup

Get-VBRBackupRepository

Get-VBRWANAccelerator

Detailed Description

This cmdlet creates a backup copy job for Endpoint backups.

The backup copy job is copying Endpoint backup files from the source backup repository to the target backup repository. The backup copy job runs continuously synchronizing the backup repositories in user-defined time periods.

The cmdlet provides two parameters sets that can be used for on-site and off-site modes:

Direct data transfer

You can create a backup copy job using direct operation. 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.

Data transfer with WAN accelerators

To transfer the data efficiently to to the off-site location, you can use the WAN accelerator technology. WAN accelerator is a backup infrastructure component that optimizes file transfer via WAN by means of data deduplication. The role of a WAN accelerator can be assigned to a dedicated Windows-based machine (physical or virtual). You should always use a pair of WAN accelerators set on source and target sides. 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.

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

Return Type

CBackupJob or VBREPJob

Parameters

Parameter	Description	Required	Position	Accept Pipeline Input	Accept Wildcard Characters
Backup	Specifies the existing Endpoint backup(s) you want to copy. You can assign multiple backups to this object.	True	Named	True (by Value FromPipeline, ValueFromPipeline ByPropertyName)	False
Name	Specifies the name you want to assign to the backup copy job. You can input string up to 255 symbols. If not set, Veeam Backup & Replication will assign a default backup copy job name.	False	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
Repository	Specifies the backup repository to where you want to copy the data. Accepts the backup repository object or string type (repository name). If not set, Veeam Backup & Replication will use the default backup repository.	False	Named	False	False
Direct Operation	Used to set the direct data transfer. Enables 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.	True	Named	False	False
Source Accelerator	Used to set data transfer with WAN accelerators. Specifies the WAN accelerator on the source side. Remember to set the pair of source and target WAN accelerators. If you select the mode using WAN accelerators, the -DirectOperation parameter should be omitted.	True	Named	False	False
Target Accelerator	Used to set data transfer with WAN accelerators. Specifies the WAN accelerator on the target side. Remember to set the pair of source and target WAN accelerators. If you select the mode using WAN accelerators, the -DirectOperation parameter should be omitted.	True	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 using the direct operation method.

The Endpoint backup is obtained with Get-VBRBackup and assigned to the '$EPbackup' variable.
The target backup repository is obtained with Get-VBRBackupRepository and assigned to the '$repository' variable.

PS C:\PS> $EPbackup = Get-VBRBackup -Name 'Backup Job Mediaserver'

PS C:\PS> $repository = Get-VBRBackupRepository -Name 'WinLocal'

PS C:\PS> Add-VBREpBackupCopyJob -Name "Mediaserver Endpoint" -Description "Mediaserver Endpoint Backup Copy Job" -Backup $EPbackup -DirectOperation -Repository $repository

Example 2

This command creates a backup copy job using WAN accelerators.

The Endpoint backup is obtained with Get-VBRBackup and piped down.
The target backup repository is obtained with Get-VBRBackupRepository and assigned to the '$repository' variable.

The source and target WAN accelerators are obtained with Get-VBRWANAccelerator and assigned to $wansource and $wantarget variables accordingly.

PS C:\PS> $repository = Get-VBRBackupRepository -Name 'WinLocal'

PS C:\PS> $wansource = Get-VBRWANAccelerator -Name "Backup WAN Sydney"

PS C:\PS> $wantarget = Get-VBRWANAccelerator -Name "Backup WAN London"

PS C:\PS> Get-VBRBackup -Name 'Backup Job Mediaserver' | Add-VBREPBackupCopyJob -Name "Mediaserver Endpoint" -Description "Mediaserver Endpoint Backup Copy Job" -Repository $repository -SourceAccelerator $wansource -TargetAccelerator $wantarget