Add-VBRBackupRepository

In this article

    Short Description

    Adds backup repositories to Veeam Backup & Replication.

    Applies to

    Platform: VMware, Hyper-V

    Product Edition: Standard, Enterprise, Enterprise Plus, Veeam Universal License

    Syntax

    This cmdlet provides parameter sets that allow you to:

    • For adding repository without authentication.

    Add-VBRBackupRepository -Folder <String> -Type <VBRRepositoryType> [-ImmutabilityPeriod <Int32>] [-EnableBackupImmutability <SwitchParameter>] [-EnableXFSFastClone <SwitchParameter>] [-DDBoostEncryptionType <VBRDDBoostEncryptionType>] [-UsePerVMFile <SwitchParameter>] [-DecompressDataBlocks <SwitchParameter>] [-AlignDataBlocks <SwitchParameter>] [-DataRateLimit <Int32>] [-LimitDatarate <SwitchParameter>] [-MaxConcurrentJobs <Int32>] [-LimitConcurrentJobs <SwitchParameter>] [-StoreOnceWanLink <SwitchParameter>][-StoreOnceServerName <String>] [-DDServerName <String>] [-MountPort <Int32>] [-VPowerNFSPort <Int32>] [-MountFolder <String>] [-RotatedDrive <SwitchParameter>] [-ImportBackup <SwitchParameter>] [-ImportIndex <SwitchParameter>] [-MountServer <CHost>] [-Server <CHost>] [-Description <String>] [-Name <String>] [-NFSRepositoryEncoding <VBRNASEncoding>] [-Force <SwitchParameter>] [<CommonParameters>]

    • For adding repository with a user name and password.

    Add-VBRBackupRepository -Folder <String> -Type <VBRRepositoryType> [-ImmutabilityPeriod <Int32>] [-EnableBackupImmutability <SwitchParameter>] [-EnableXFSFastClone <SwitchParameter>] [-DDBoostEncryptionType <VBRDDBoostEncryptionType>] [-UsePerVMFile <SwitchParameter>] [-DecompressDataBlocks <SwitchParameter>] [-AlignDataBlocks <SwitchParameter>] [-DataRateLimit <Int32>] [-LimitDatarate <SwitchParameter>] [-MaxConcurrentJobs <Int32>] [-LimitConcurrentJobs <SwitchParameter>] [-Password <String>] [-UserName <String>] [-StoreOnceWanLink <SwitchParameter>] [-StoreOnceServerName <String>] [-DDServerName <String>] [-MountPort <Int32>] [-VPowerNFSPort <Int32>] [-MountFolder <String>] [-RotatedDrive <SwitchParameter>] [-ImportBackup <SwitchParameter>] [-ImportIndex <SwitchParameter>] [-MountServer <CHost>] [-Server <CHost>] [-Description <String>] [-Name <String>] [-NFSRepositoryEncoding <VBRNASEncoding>] [-Force <SwitchParameter>]   [<CommonParameters>]

    • For adding repository using credentials.

    Add-VBRBackupRepository -Folder <String> -Type <VBRRepositoryType> [-ImmutabilityPeriod <Int32>] [-EnableBackupImmutability <SwitchParameter>] [-EnableXFSFastClone <SwitchParameter>] [-DDBoostEncryptionType <VBRDDBoostEncryptionType>] [-UsePerVMFile <SwitchParameter>] [-DecompressDataBlocks <SwitchParameter>][-AlignDataBlocks <SwitchParameter>] [-DataRateLimit <Int32>] [-LimitDatarate <SwitchParameter>] [-MaxConcurrentJobs <Int32>] [-LimitConcurrentJobs <SwitchParameter>] [-Credentials <CCredentials>] [-StoreOnceWanLink <SwitchParameter>] [-StoreOnceServerName <String>] [-DDServerName <String>] [-MountPort <Int32>] [-VPowerNFSPort <Int32>] [-MountFolder <String>] [-RotatedDrive <SwitchParameter>] [-ImportBackup <SwitchParameter>] [-ImportIndex <SwitchParameter>] [-MountServer <CHost>] [-Server <CHost>] [-Description <String>] [-Name <String>] [-NFSRepositoryEncoding <VBRNASEncoding>] [-Force <SwitchParameter>]    [<CommonParameters>]

    Detailed Description

    This cmdlet adds a new backup repository to Veeam Backup & Replication.

    When adding a backup repository, you may need to provide a user name/password or credentials to authenticate with the server or appliance that you want to use as the repository. Authenticating is needed for the following sources:

    • Shared folders
    • Dell EMC Data Domain storage appliances
    • ExaGrid storage appliances
    • HPE StoreOnce storage appliances

    This cmdlet provides three parameter sets for each case including no authentication.

    To add a scale-out backup repository, run the Add-VBRScaleOutBackupRepository cmdlet.

    Parameters

    Parameter

    Description

    Required

    Position

    Accept
    Pipeline
    Input

    Accept
    Wildcard
    Characters

    Folder

    Specifies the full path to the folder where you want to store the backups.

    True

    Named

    False

    False

    Type

    Specifies the type you want to assign to the repository:

    • WinLocal
    • LinuxLocal
    • CifsShare
    • ExaGrid
    • DataDomain
    • HPStoreOnceIntegration
    • Quantum
    • Nfs

    True

    Named

    False

    False

    ImmutabilityPeriod

    For the immutability option.

    Defines a number of days within which Veeam Backup & Replication will not delete blocks of data from the backup repository.

    Default: 30 days.

    False

    Named

    False

    False

    EnableBackupImmutability

    Enables the immutability option for a backup repository.

    False

    Named

    False

    False

    NFSRepositoryEncoding

    Specifies encoding for NFS share. You can specify either of the following values:

    • utf
    • ansi

    False

    Named

    False

    False

    Force

    Defines that the cmdlet will a backup repository without showing warnings in the PowerShell console.

    False

    Named

    False

    False

    Name

    Specifies the name you want to assign to the new backup repository.

    False

    Named

    False

    False

    Description

    Specifies the description of the backup repository.

    False

    Named

    False

    False

    Server

    Specifies the host where the backup repository you want to add is located.

    Use this parameter to explicitly set the host for the following repository types:

    • WinLocal: to specify a Windows based server where you want to create the backup repository or to which you want to connect the rotated drives.
    • LinuxLocal type: to specify a Linux based server where you want to create the backup repository or to which you want to connect the rotated drives.
    • CifsShare, DataDomain or HPStoreOnce: to specify a Windows based server to which the storage appliance is connected and which will be used as a gateway server.

    Default: This server.

    False

    Named

    False

    False

    MountServer

    Specifies the mount server associated with the backup repository. You can assign the mount server role to the backup repository itself or to a server that resides close to the backup repository.

    False

    Named

    False

    False

    ImportIndex

    Indicates that the cmdlet will import the guest OS file system index.

    False

    Named

    False

    False

    ImportBackup

    Indicates that the cmdlet will import backups that are currently located on the server you are adding as repository.

    False

    Named

    False

    False

    RotatedDrive

    Indicates that the repository you want to add is a rotated drive (removable media).

    False

    Named

    False

    False

    MountFolder

    Specifies the path to the mount folder. Veeam Backup & Replication will use this folder to mount VM disks  and to keep write cache data.

    False

    Named

    False

    False

    VPowerNFSPort

    Specifies the port number of the vPower NFS Service. Veeam Backup & Replication will set up a direct connection between the backup repository and ESXi to which the vPower NFS datastore is mounted.

    Default: 2049.

    False

    Named

    False

    False

    MountPort

    Specifies the port number of the mount server.

    Default: 1058.

    False

    Named

    False

    False

    DDServerName

    Specifies the Data Domain server name. Enter the name in the following formats depending on the connection mode:

    • If Dell EMC Data Domain works over TCP/IP, enter a full DNS name or an IP address of the Dell EMC Data Domain server.
    • If Dell EMC Data Domain works over Fibre Channel, enter a name of the Data Domain server starting with a 'DFC-' prefix, for example, "DFC-DataDomain690"

    False

    Named

    False

    False

    StoreOnceServerName

    Specifies the HPE StoreOnce server name.

    False

    Named

    False

    False

    StoreOnceWanLink

    Indicates that the HPE StoreOnce must use source-side deduplication.

    False

    Named

    False

    False

    LimitConcurrentJobs

    Indicates that the number of concurrent jobs using this repository must be limited.

    Use the MaxConcurrentJobs parameter to set the maximum value.

    False

    Named

    False

    False

    MaxConcurrentJobs

    Used for setting maximum value for the LimitConcurrentJobs parameter.

    Specifies the maximum allowed number of concurrent tasks for the backup repository.

    Permitted values: 1 to 99.

    False

    Named

    False

    False

    LimitDatarate

    Indicates that the total speed of writing data to the backup repository disk must be restricted.

    Use the DataRateLimit parameter to set the maximum value.

    False

    Named

    False

    False

    DataRateLimit

    Used for setting combined data ingestion rate for the LimitDatarate parameter.

    Specifies the combined data ingestion rate for the repository.

    Permitted value: 1 to 1024 (MByte/s).

    False

    Named

    False

    False

    AlignDataBlocks

    Indicates that the backup blocks size will be aligned by a 4Kb block boundary. Data alignment provides better deduplication on storage systems with fixed block size.

    False

    Named

    False

    False

    DecompressDataBlocks

    Indicates that the backup data blocks must be decompressed before storing to the repository.

    False

    Named

    False

    False

    UsePerVMFile

    Indicates that the backup repository must create per-VM backup files.

    False

    Named

    False

    False

    DDBoostEncryptionType

    Specifies the native Dell EMC Data Domain encryption level:

    • High
    • Medium
    • None

    False

    Named

    False

    False

    UserName

    Specifies the user name you want to use for authenticating with the backup repository host.

    False

    Named

    False

    False

    Password

    Specifies the password you want to use for authenticating with the backup repository host.

    False

    Named

    False

    False

    Credentials

    Specifies credentials you want to use for authenticating with the backup repository host.

    False

    Named

    False

    False

    EnableXFSFastClone

    Defines that the Fast Clone technology will be enabled for the 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.

    Examples

    Add-VBRBackupRepositoryExample 1. Adding Windows Server as Backup Repository

    This example shows how to add the Win2012 Windows server as a new backup repository named "Win2012Repo". The cmdlet will add the backup repository with the following settings:

    • Veeam Backup & Replication does not authenticate against the Win2012 Windows server.
    • The folder that is used as the backup repository is located on "C:\Backup Repository".
    • The server type is set to "WinLocal".

     

    $server = Get-VBRServer -Name "Win2012"

    Add-VBRBackupRepository -Name "Win2012Repo" -Server $server -Folder "c:\Backup Repository" -Type WinLocal

    Perform the following steps:

    1. Run the Get-VBRServer cmdlet. Specify the Name parameter value. Save the result to the $server variable.
    2. Run the Add-VBRBackupRepository cmdlet. Specify the following settings:
    • Specify the Name parameter value.
    • Set the $server variable as the Server parameter value.
    • Specify the Folder parameter value.
    • Specify the Type parameter value.

    Add-VBRBackupRepositoryExample 2. Adding Shared Folder as Backup Repository

    This example shows how to add a shared folder on a Windows server as the Backups Vol 01 backup repository. The cmdlet will add the backup repository with the following settings:

    • Veeam Backup & Replication uses credentials to authenticate against the shared folder.
    • The C:\Backup Repository folder is used as the backup repository.
    • The server type is set to WinLocal.
    • The ImportBackup parameter is set to import the existing backup files.
    • The maximum allowed number of concurrent tasks is set to 6.

     

    $server = Get-VBRServer -Name "Win2012"

    $administrator = Get-VBRCredentials -Name *Administrator*

    Add-VBRBackupRepository -Name "Backups Vol 01" -Server $server -Folder "C:\Backup Repository" -Type WinLocal -ImportBackup:$true -LimitConcurrentJobs -MaxConcurrentJobs 6 -Credentials $administrator

    Perform the following steps:

    1. Run the Get-VBRServer cmdlet. Specify the Name parameter value. Save the result to the $server variable.
    2. Run the Get-VBRCredentials cmdlet. Specify the Name parameter value. Save the result to the $administrator variable
    3. Run the Add-VBRBackupRepository cmdlet. Specify the following settings:
    • Specify the Name parameter value.
    • Set the $server variable as the Server parameter value.
    • Specify the Folder parameter value.
    • Specify the Type parameter value.
    • Set the ImportBackup parameter to $true.
    • Provide the LimitConcurrentJobs parameter.
    • Specify the MaxConcurrentJobs parameter value.
    • Set the $administrator as the Credentials parameter value.

    Add-VBRBackupRepositoryExample 3. Adding Dedupe Storage Aplliance as Backup Repository

    This example shows how to add a Dell EMC Data Domain storage appliance as a backup repository. The cmdlet will add the backup repository with the following settings:

    • Dell EMC Data Domain connects to the WinSrv05 explicitly set gateway server.
    • The DFC prefix is not set to allow Veeam Backup & Replication to communicate with Dell EMC Data Domain storage over the TCP/IP protocol.
    • Veeam Backup & Replication will store backup files in the folder located in the following path: DataDomain://10.0.0.80:storage/
    • The Username/Password is used to get access to the appliance.

     

    $server = Get-VBRServer -Name "WinSrv05"

    Add-VBRBackupRepository -Folder DataDomain://10.0.0.80:storage/ -Type DataDomain -DDServerName 10.0.0.80 -Server $server -UserName sysadmin -Password Pa55word

    Perform the following steps:

    1. Run the Get-VBRServer cmdlet. Specify the Name parameter value. Save the result to the $server variable.
    1. Run the Add-VBRBackupRepository cmdlet. Specify the following settings:
    • Specify the Folder parameter value.
    • Specify the Type parameter value.
    • Specify the DDServerName parameter value.
    • Set the $server variable as the Server parameter value.
    • Specify the UserName parameter value.
    • Specify the Password parameter value.

    Add-VBRBackupRepositoryExample 4. Adding Backup Repository on Rotated Drive

    This example shows how to add backup repository on a rotated drive connected to a Windows server. The cmdlet will add the backup repository with the following settings:

    • The server type is set to WinLocal.
    • Veeam Backup & Replication will store backup files in the folder located in the following path: F:\Repo.

     

     

    $server = Get-VBRServer -Name "WinSrv05"

    Add-VBRBackupRepository -Name RDX -Type WinLocal -RotatedDrive -Description "Rotated drive" -Server $server -Folder F:\Repo

    Perform the following steps:

    1. Run the Get-VBRServer cmdlet. Specify the Name parameter value. Save the result to the $server variable.
    1. Run the Add-VBRBackupRepository cmdlet. Specify the following settings:
    • Specify the Name parameter value.
    • Specify the Type parameter value.
    • Provide the RotatedDrive parameter.
    • Specify the Description parameter value.
    • Set the $server variable as the Server parameter value.
    • Specify the Folder parameter value.

    Add-VBRBackupRepositoryExample 5. Adding Quantum DXi Storage Appliance as Backup Repository

    This example shows how to add a Quantum DXi storage appliance as a backup repository. Veeam Backup & Replication will store backup files in the folder located in the following path: /shares/Quantum-Share-01.

    $server = Get-VBRServer -Name "WinSrv05"

    Add-VBRBackupRepository -Name "Quantum DXi" -Type Quantum -Folder "/shares/Quantum-Share-01" -Server $server

    Perform the following steps:

    1. Run the Get-VBRServer cmdlet. Specify the Name parameter value. Save the result to the $server variable.
    2. Run the Add-VBRBackupRepository cmdlet. Specify the following settings:
    • Specify the Name parameter value.
    • Specify the Type parameter value.
    • Specify the Folder parameter value.
    • Set the $server variable as the Server parameter value.

    Add-VBRBackupRepositoryExample 6. Adding ExaGrid Share as Backup Repository

    The example shows how to add ExaGrid as a backup repository. Veeam Backup & Replication will store backup files in the folder located in the following path: /home/Admin/Share01-07/MyRepo. The pattern of this folder path consists of the following elements:

    1. /home: A home directory
    2. /Admin: Must be the same as the user name that you use to authenticate against the Linux server when you add it to Veeam Backup & Replication. In our example it is specified by the SSHUser parameter of the Add-VBRLinux cmdlet.
    3. /Share01-07: The folder that you must create on the Exagrid appliances beforehand.
    4. [Optional] /MyRepo/: Subfolder that you may want to create in the Share01-07 folder.

    $linsrv = Add-VBRLinux -Name "172.18.4.67" -SSHUser Admin -SSHPassword P@$$w0rd

    Add-VBRBackupRepository -Name ExaGrid -Server $srv -Type ExaGrid -Folder "/home/Admin/Share01-07/MyRepo/"

    Perform the following steps:

    1. Run the Add-VBRLinux cmdlet. Specify the necessary parameters. Save the result to the $linsrv variable.
    2. Run the Add-VBRBackupRepository cmdlet. Specify the following settings:
    • Specify the Name parameter value.
    • Set the Type parameter to the ExaGrid value.
    • Set the $srv variable as the Server parameter value.
    • Specify the Folder parameter value.

    Add-VBRBackupRepositoryExample 7. Adding HPE StoreOnce as Backup Repository

    This example shows how to add HPE StoreOnce as a backup repository. Veeam Backup & Replication will store backup files in the folder located in the following path: storeonce://HPEStoreO01-dl.local:Store-015/. The pattern of this folder path consists of the following elements:

    1. //HPEStoreO01-dl.local: The name of HPE StoreOnce.
    2. :Store-015@/: The name of the HPE StoreOnce Catalyst Store.
      Note: It is not recommended to specify any subfolders in this folder, since currently Veeam Backup & Replication is able to display only the name of HPE StoreOnce Catalyst Store. If you indeed want to specify a subfolder, review this KB article but keep in mind that you will not be able to manage the backup repository with the user interface of Veeam Backup & Replication.

    $creds = Get-VBRCredentials -Name "HPEStorOnce"

    Add-VBRBackupRepository -Type HPStoreOnceIntegration -Name "Atlanta Repository" -StoreOnceServerName "HPEStoreO01-dl.local" -Folder "storeonce://HPEStoreO01-dl.local:Store-015@/" -Credentials $creds

    Perform the following steps:

    1. Run the Get-VBRCredentials cmdlet. Save the result to the $creds varible.
    2. Run the Add-VBRBackupRepository cmdlet. Specify the following settings:
    • Set the Type parameter to the HPStoreOnceIntegration value.
    • Specify the Name parameter value.
    • Specify the StoreOnceServerName parameter value.
    • Specify the Folder parameter value.
    • Set the $creds variable as the Credentials parameter value.

    Related Commands

    I want to report a typo

    There is a misspelling right here:

     

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