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

Add-VBRTapeFilesJob (obsolete)

In this article

    Short Description

    Creates a new files to tape copy job.

    Add-VBRTapeFilesJob (obsolete) Note:

    This cmdlet is obsolete. It Veeam Backup & Replication v.8.0 it was replaced by Add-VBRFileToTapeJob. The cmdlet will still work but it is advised to rewrite your scripts using the new cmdlet for added benefits.

    Applies to

    Platform: VMware, Hyper-V

    Syntax

    Add-VBRTapeFilesJob [-Name <String>] -Server <CHost> -Path <String[]> -MediaPool <MediaPool> [-MediaPoolIncremental <MediaPool>] [-Description <String>] [-Credentials <CCredentials>] [-Masks <String>] [-IgnoreCase] [-WarningAction <ActionPreference>] [-WarningVariable <String>] [<CommonParameters>]

    Related Commands

    Get-VBRServer

    Get-VBRTapeMediaPool

    Get-VBRCredentials

    Detailed Description

    This cmdlet creates a new job copying files from Veeam Backup & Replication to tape. The tape job looks for changes in the specified files that have been made from the moment of the last tape job run.

    Note that when you create a copy job, you need to run it manually.

    Run Start-VBRJob to start the created job.

    Parameters

    Parameter

    Description

    Required

    Position

    Accept
    Pipeline
    Input

    Accept
    Wildcard
    Characters

    Name

    Specifies the name you want to assign to the new files to tape copy job.

    You can input string up to 255 symbols.

    False

    Named

    False

    False

    Server

    Specifies the source server where the files you need are located.

    True

    Named

    False

    False

    Path

    Specifies the path to the folder(s) you need to copy. Use -Masks and -IgnoreCase parameters to select particular files.

    You can specify multiple names separated by commas.

    True

    Named

    True (ByValue,
    ByProperty
    Name)

    False

    MediaPool

    Specifies the target media pool that will be used for full backups.

    True

    Named

    False

    False

    MediaPool
    Incremental

    Specifies the target media pool that will be used for incremental backups.

    False

    Named

    False

    False

    Description

    Specifies the description for the new files to tape copy job.

    False

    Named

    False

    False

    Credentials

    Specifies the credentials you want to use for authenticating with the source server.

    False

    Named

    False

    False

    Masks

    Used to specify search conditions for -Path paramater.

    Specifies masks to select files in folders.

    False

    Named

    False

    False

    IgnoreCase

    Used to specify search conditions for -Path paramater.

    If set, the search by name will be non case sensitive.

    False

    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 new files to tape copy job named "Contacts Copy Job". The source server containing the files to be copied is obtained with Get-VBRServer and assigned to the $server variable. The target media pools for full backups and incremental backups are obtained with Get-VBRTapeMediaPool and assigned to $full and $increment variables beforehand accordingly. The source file path is D:\Users\UserInfo\Contacts.xls.

    Add-VBRTapeFilesJob -Name "Contacts Copy Job" -Server $server -Path "D:\Users\UserInfo\Contacts.xls"  -MediaPool $full -MediaPoolIncremental $increment

    Example 2

    This command creates a new files to tape copy job named "Agreements Copy Job" copying .pdf files from the "Signed" folder. The source server containing the files to be copied is obtained with Get-VBRServer and assigned to the $server variable. The target media pools for full backups and incremental backups are obtained with Get-VBRTapeMediaPool and assigned to $full and $increment variables beforehand accordingly. The source file path is D:\Agreements\Signed. The mask for selecting files to copy is ".pdf".

    Add-VBRTapeFilesJob -Name "Agreements Copy Job" -Server $server -Path "D:\Agreements\Signed" -MediaPool $full -MediaPoolIncremental $increment -Description "Agreements File Copy Job" -Credentials $Administrator -Masks *.pdf