Add-VBREPBackupCopyJob (obsolete)

Short Description

Important

This cmdlet is obsolete and only works for creating a simple mode backup copy job. It is recommended to create a new backup job using the Add-VBRBackupCopyJob cmdlet.

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

Syntax

This cmdlet provides the following parameter sets:

DirectOperation

Add-VBREpBackupCopyJob [-Name <String>] [-Description <String>] [-Backup <CBackup[]>] [-BackupJob <VBREPJob[]>]

[-SourceRepository <CBackupRepository[]>] -OSPlatform <VBRAgentType> [-Repository <CBackupRepository>]

[-DirectOperation] [-EnableImmediateCopy] [-Force] [<CommonParameters>]

WanAccelerator

Add-VBREpBackupCopyJob [-Name <String>] [-Description <String>] [-Backup <CBackup[]>] [-BackupJob <VBREPJob[]>]

[-SourceRepository <CBackupRepository[]>] -OSPlatform <VBRAgentType> [-Repository <CBackupRepository>]

-SourceAccelerator <CWanAccelerator> [-TargetAccelerator <CWanAccelerator>] [-EnableImmediateCopy] [-Force] [<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 a disabled state. Run the Enable-VBRJob cmdlet 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

Parameters
Parameter	Description	Type	Required	Position	Accept Pipeline Input
Backup	Specifies the array of backups you want to copy. Accepts the `CBackup[]` object. To get this object, run the `Get-VBRBackup` cmdlet.	`CBackup[]`	False	Named	True (ByPropertyName, ByValue)
BackupJob	Specifies the backup job. The cmdlet will add this job to a backup copy job. Accepts the `VBREPJob[]` object. To get this object, run the `Get-VBREPJob` cmdlet.	`VBREPJob[]`	False	Named	True (ByPropertyName)
Description	Specifies the description of the backup copy job.	`String`	False	Named	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).	`SwitchParameter`	True	Named	False
EnableImmediateCopy	Defines that the cmdlet will enable the immediate copy mode. If you specify this parameter, Veeam Backup & Replication will copy new restore points and logs as soon as they appear. Otherwise, Veeam Backup & Replication will copy data from backups once per backup copy interval.	`SwitchParameter`	False	Named	False
Force	Defines that the cmdlet will create backup copy jobs without showing warnings in the PowerShell console.	`SwitchParameter`	False	Named	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.	`String`	False	Named	False
OSPlatform	Specifies the OS of the computers where Veeam Agent will operate: `Windows`: for Windows computers. `Linux`: for Linux computers. `Mac`: for macOS computers. `Unix`: for Unix computers.	`VBRAgentType`	True	Named	False
Repository	Specifies the backup repository to where you want to copy data. Default: default backup repository. Accepts `CBackupRepository` object or string. To get this object, run the `Get-VBRBackupRepository` cmdlet.	`CBackupRepository`	False	Named	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. Accepts the `CWanAccelerator` object. To get this object, run the `Get-VBRWANAccelerator` cmdlet.	`CWanAccelerator`	True	Named	False
SourceRepository	Specifies an array of source backup repositories. Accepts the `CBackupRepository[]` object. To get this object, run the `Get-VBRBackupRepository` cmdlet.	`CBackupRepository[]`	False	Named	True (ByPropertyName)
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. Accepts the `CWanAccelerator` object. To get this object, run the `Get-VBRWANAccelerator` cmdlet.	`CWanAccelerator`	False	Named	False

<CommonParameters>

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

Output Object

CBackupJob
VBREPJob

Examples

Add-VBREPBackupCopyJob (obsolete) Example 1. Creating Backup Copy Job with Direct Data Transfer

This example shows how to create a backup copy job with the direct data transfer.

$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

Perform the following steps:

Run the Get-VBRBackup cmdlet. Specify the Name parameter value. Save it to the $EPbackup variable.
Run the Get-VBRBackupRepository cmdlet. Specify the Name parameter value. Save it to the $repository variable.
Run the Add-VBREpBackupCopyJob cmdlet. Specify the following settings:
- Specify the Name parameter value.
- Specify the Description parameter value.
- Set the $EPbackup variable as the Backup parameter value.
- Provide the DirectOperation parameter.
- Set the $repository variable as the Repository parameter value.

Add-VBREPBackupCopyJob (obsolete) Example 2. Creating Backup Copy Job with WAN Accelerators

This example shows how to create a backup copy job using WAN accelerators.

$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" -Backup $EPbackup -Repository $repository -SourceAccelerator $wansource -TargetAccelerator $wantarget

Perform the following steps:

Run the Get-VBRBackup cmdlet. Specify the Name parameter value. Save it to the $EPbackup variable.
Run the Get-VBRBackupRepository cmdlet. Specify the Name parameter value. Save it to the $repository variable.
Run the Get-VBRWANAccelerator cmdlet to get a source and a target Wan accelerators. Specify the Name parameter value. Save them to the $wansource and $wantarget variables accordingly.
Run the Add-VBREpBackupCopyJob cmdlet. Specify the following settings:
- Specify the Name parameter value.
- Specify the Description parameter value.
- Set the $EPbackup variable as the Backup parameter value.
- Set the $repository variable as the Repository parameter value.
- Set the $wansource variable as the SourceAccelerator parameter value.
- Set the $wantarget variable as the TargetAccelerator parameter value.