Add-VBREPBackupCopyJob

In this article

    Short Description

    Creates backup copy jobs for Veeam Agent for Microsoft Windows backups.

    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>]

    Detailed Description

    This cmdlet creates a backup copy job for Veeam Agent for Microsoft Windows backups.

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

    Add-VBREPBackupCopyJob Note:

    Veeam Agent for Microsoft Windows cmdlets will not work for jobs that were created using Veeam Agent management functionality. The ability to manage Veeam Agent management jobs will be provided in future versions of Veeam PowerShell.

    Parameters

    Parameter

    Description

    Required

    Position

    Accept
    Pipeline
    Input

    Accept
    Wildcard
    Characters

    Backup

    Specifies the array of Veeam Agent for Microsoft Windows backups you want to copy.

    True

    Named

    True (ByValue,
    ByProperty
    Name)

    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

    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

    DirectOperation

    Used for the direct data transfer.

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

    True

    Named

    False

    False

    SourceAccelerator

    Used for the data transfer using WAN accelerators.

    Specifies the WAN accelerator on the source side.

    Remember to set the pair of source and target WAN accelerators.

    True

    Named

    False

    False

    TargetAccelerator

    Used for the data transfer using WAN accelerators.

    Specifies the WAN accelerator on the target side.

    Remember to set the pair of source and target WAN accelerators.

    True

    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

    I want to report a typo

    There is a misspelling right here:

     

    I want to let the Veeam Documentation Team know about that.