Add-VBREPBackupCopyJob
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
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 | Accept |
Backup | Specifies the existing Endpoint backup(s) you want to copy. You can assign multiple backups to this object. | True | Named | True (by Value | 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 | 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 | 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 | 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 |
<CommonParameters>
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 |