Add-VBREpBackupCopyJob

Short Description

Creates backup copy jobs for Veeam Agent operating in a standalone mode.

Syntax

This cmdlet provides parameter sets that allow you to:

  • Create backup copy jobs that will transfer data directly.

Add-VBREpBackupCopyJob -DirectOperation <SwitchParameter> [-Name <String>] [-Description <String>] [-Backup <CBackup[]>] [-BackupJob <VBREPJob[]>] [-Repository <CBackupRepository>][-Force <SwitchParameter>] [<CommonParameters>]

  • Create backup copy jobs that will transfer data over WAN accelerators.

Add-VBREpBackupCopyJob -SourceAccelerator <CWanAccelerator> -TargetAccelerator <CWanAccelerator> [-Name <String>] [-Description <String>] [-Backup <CBackup[]>] [-BackupJob <VBREPJob[]>] [-Repository <CBackupRepository>] [-Force <SwitchParameter>] [<CommonParameters>]

Detailed Description

This cmdlet creates backup copy jobs for Veeam Agent operating in a standalone mode.

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

Run the Add-VBRComputerBackupCopyJob cmdlet to create backup copy jobs that use Veeam Agent management functionality.

Parameters

Parameter

Description

Required

Position

Accept
Pipeline
Input

Accept
Wildcard
Characters

Backup

Specifies the array of backups you want to copy.

True

Named

True (ByValue,
ByProperty
Name)

False

DirectOperation

Used for the direct data transfer.

Enables direct data transfer sending the data directly to the target backup repository without performing data deduplication.

Note that this parameter is required if the WAN acceleration is not used (the SourceAccelerator and TargetAccelerator parameters are not specified).

True

Named

False

False

SourceAccelerator

Used for the data transfer using WAN accelerators.

Specifies the WAN accelerator on the source side.

Note that this parameter is required if the Direct Operation is not used (the DirectOperation parameter is not specified). If you specify this parameter and the repository specified in the Repository parameter is not cloud, you must also specify the TargetAccelerator parameter.

True

Named

False

False

TargetAccelerator

Used for the data transfer using WAN accelerators.

Specifies the WAN accelerator on the target side.

Note that this parameter is required if the WAN acceleration is used (the SourceAccelerator is specified) and the repository specified in the Repository parameter is not cloud.

True

Named

False

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.

False

Named

False

False

BackupJob

Specifies the backup job. The cmdlet will add this job to a backup copy job.

False

Named

True (ByPropertyName)

False

Force

Defines that the cmdlet will create backup copy jobs without showing warnings in the PowerShell console.

False

Named

False

False

Repository

Specifies the backup repository to where you want to copy the data.

Accepts backup repository object or string (repository name) type.

Default: default backup repository.

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.

Return Type

CBackupJob or VBREPJob

Example 1

This command creates a backup copy job with the direct data transfer.

  1. Run Get-VBRBackup to get the source backup and save it to the $EPbackup variable.
  2. Run Get-VBRBackupRepository to get the repository and save it to the $repository variable.
  3. Run Add-VBREpBackupCopyJob with the $EPbackup and $repository variables. Use the DirectOperation parameter.

$EPbackup = Get-VBRBackup -Name "Backup Job Mediaserver"

$repository = Get-VBRBackupRepository -Name "WinLocal"

Add-VBREpBackupCopyJob -Name "Mediaserver Endpoint Backup Copy" -Description "Mediaserver Endpoint Backup Copy Job" -Backup $EPbackup -DirectOperation -Repository $repository

Example 2

This command creates a backup copy job using WAN accelerators.

  1. Run Get-VBRBackup to get the source backup and save it to the $EPbackup variable.
  2. Run Get-VBRBackupRepository to get the repository and save it to the $repository variable.
  3. Run Get-VBRWANAccelerator to get a source and a target Wan accelerators. Save them to the $wansource and $wantarget variables accordingly.
  4. Run Add-VBREpBackupCopyJob with the variables, obtained beforehand.

$EPbackup = Get-VBRBackup -Name "Backup Job Mediaserver"

$repository = Get-VBRBackupRepository -Name "WinLocal"

$wansource = Get-VBRWANAccelerator -Name "Backup WAN Sydney"

$wantarget = Get-VBRWANAccelerator -Name "Backup WAN London"

Add-VBREPBackupCopyJob -Name "Mediaserver Endpoint Backup Copy" -Description "Mediaserver Endpoint Backup Copy Job" -Repository $repository -SourceAccelerator $wansource -TargetAccelerator $wantarget

Related Commands

Get-VBRBackup

Get-VBRBackupRepository

Get-VBRWANAccelerator