Add-VBRScaleOutBackupRepository

In this article

    Short Description

    Adds scale-out backup repositories to Veeam Backup & Replication.

    Product Edition: Enterprise, Enterprise Plus, Veeam Universal License

    Syntax

    Add-VBRScaleOutBackupRepository -PolicyType {DataLocality | Performance} -Extent <CBackupRepository[]> [-Name <string>] [-Description <string>] [-UsePerVMBackupFiles] [-PerformFullWhenExtentOffline] [-EnableCapacityTier] [-OperationalRestorePeriod <int>] [-EnableOverridePolicy] [-OverrideSpaceThreshold <int>] [-OffloadWindowOptions <VBRBackupWindowOptions>] [-ObjectStorageRepository <VBRObjectStorageRepository>] [-EnableEncryption] [-EncryptionKey <VBREncryptionKey>] [-EnableCapacityTierMovePolicy] [-EnableCapacityTierCopyPolicy] [-EnableArchiveTier] [-ArchiveObjectStorageRepository <VBRArchiveObjectStorageRepository>] [-ArchivePeriod <int>] [-EnableCostOptimizedArchive] [-EnableFullBackupArchiveMode] [-EnablePluginBackupOffload] [-EnableCopyAllPluginBackups] [-EnableCopyAllMachineBackups] [-Force]  [<CommonParameters>]

    Detailed Description

    This cmdlet creates scale-out backup repositories. You can create the scale-out backup repositories with the following options:

    • The performance tier option. To implement this option, you must add local backup repositories as performance extents to the scale-out backup repository.
    • Performance tier and capacity tier options. To implement this option, you must add local backup repositories and object storage repositories to the scale-out backup repository.
    • Performance tier, capacity tier and archive tier options. To implement this option, you must add local backup repositories, object storage repositories and archive object storage repositories to the scale-out backup repository.

    Run the Get-VBRBackupRepository cmdlet to get backup repositories.

    Run the Get-VBRObjectStorageRepository cmdletto get object storage repositories.

    By default, Veeam Backup & Replication only moves backup files that form inactive backup chains. For more information about backup chains, see the Backup Chain Legitimacy section of User Guide for VMware vSphere.

    If you want to move a backup file manually, run the Start-VBROffloadBackupFile cmdlet.

    Parameters

    Parameter

    Description

    Type

    Required

    Position

    Accept
    Pipeline
    Input

    PolicyType

    Specifies the policy for the scale-out repository:

    • DataLocality - use this policy to store backup files that belong to the same backup chain.
    • Performance - to store full and incremental backup files to different extents of the scale-out backup repository.

    VBRScaleOutBackupRepositoryPolicyType

    True

    Named

    True (ByProperty
    Name)

    Extent

    Specifies the array of backup repositories. The cmdlet will add these repositories as performance extents to the scale-out repository.

    Accepts the CBackupRepository[] object. To create this object, run the Get-VBRBackupRepository cmdlet.

    True

    Named

    True (ByValue,
    ByProperty
    Name)

    Name

    Specifies the name of the scale-out repository.

    String

    False

    Named

    True (ByProperty
    Name)

    Description

    Specifies the description of the scale-out repository.

    String

    False

    Named

    True (ByProperty
    Name)

    UsePerVMBackupFiles

    If set to True, the repository will store each VM in the job as a separate backup file.

    If set to False, each restore point will contain all VMs in the job.

    SwitchParameter

    False

    Named

    True (ByProperty
    Name)

    PerformFullWhenExtentOffline

    If set to True, the job will create an active full backup if the extent with the previous backup file is offline.

    If set to False, the job will fail to create an increment.

    SwitchParameter

    False

    Named

    True (ByProperty
    Name)

    EnableCapacityTier

    Enables the capacity tier option. Veeam Backup & Replication will move backup files to an object storage.

    SwitchParameter

    False

    Named

    True (ByProperty
    Name)

    OperationalRestorePeriod

    For retention policy.

    Specifies the number of days to keep backup files on the local repository. When the number of days is passed, Veeam Backup & Replication will move backup files to an object storage.

    NOTE: If you select zero days, Veeam Backup & Replication will move all backup files from the local repository to the object storage immediately.

    Int

    False

    Named

    True (ByProperty
    Name)

    EnableOverridePolicy

    Indicates that Veeam Backup & Replication will move backup files from the local repository to an object storage when the capacity reaches limits. If set, this option overrides the retention policy. Veeam Backup & Replication will move backup files to an object storage even if the retention policy value has not reached limits.

    Use the OverrideSpaceThreshold parameter to specify the capacity value.

    SwitchParameter

    False

    Named

    True (ByProperty
    Name)

    OverrideSpaceThreshold

    For the override option.

    Specifies the capacity value in percent for the override optoin. Once the value reaches the limit, Veeam Backup & Replication will move the data from the local repository to an object storage.

    Int

    False

    Named

    True (ByProperty
    Name)

    OffloadWindowOptions

    Specifies the time interval, when Veeam Backup & Replication is allowed will move the backup files to an object storage.

    Accepts the VBRBackupWindowOptions object. To create this object, run the New-VBRBackupWindowOptions cmdlet.

    False

    Named

    True (ByProperty
    Name)

    ObjectStorageRepository

    Specifies an object storage. Veeam Backup & Replication will move the backup files to this object storage.

     

    Accepts the VBRObjectStorageRepository object. To create this object, run the Get-VBRObjectStorageRepository cmdlet.

    False

    Named

    True (ByProperty
    Name)

    EnableEncryption

    Indicates that the encryption option is enabled. Veeam Backup & Replication will encrypt backup files before moving them to an object storage. Veeam Backup & Replication will encrypt all backup files from the backup chain, including the metadata.

    Use the EncryptionKey parameter to specify the encryption key.

    SwitchParameter

    False

    Named

    False

    EncryptionKey

    For the encryption option.

    Specifies an encryption key. Veeam Backup & Replication will use this key to encrypt the data.

    Accepts the VBREncryptionKey object. To get this object, run the Add-VBREncryptionKey cmdlet.

    False

    Named

    False

    Force

    Indicates that the cmdlet will create the scale-out backup repository without showing up warnings in the PowerShell console.

    SwitchParameter

    False

    Named

    False

    EnableCapacityTierMovePolicy

    Defines that the cmdlet wiil move inactive backup chains to object storage.

    SwitchParameter

    False

    Named

    False

    EnableCapacityTierCopyPolicy

    Defines that the cmdlet wiil copy new backup files to object storage as soon as they are created.

    SwitchParameter

    False

    Named

    False

    EnableArchiveTier

    Enables the archive tier option. Veeam Backup & Replication will move backup files to an archive storage.

    SwitchParameter

    False

    Named

    True (ByPropertyName)

    ArchiveObjectStorageRepository

    Specifies an archive storage. Veeam Backup & Replication will move the backup files to this archive storage.

     

    Accepts the VBRArchiveObjectStorageRepository object. To create this object, run the Get-VBRArchiveObjectStorageRepository cmdlet.

    False

    Named

    True (ByPropertyName)

    ArchivePeriod

    For retention policy.

    Specifies the number of days to keep backup files on the archive extent. When the number of days is passed, Veeam Backup & Replication will delete outdated backup files.

    Int.

    False

    Named

    False

    EnableCostOptimizedArchive

    Enables the option to archive backup files only if the remaining retention time is above minimal storage period.

    SwitchParameter

    False

    Named

    False

    EnableArchiveFullBackupMode

    Enables the option to store archived backups as standalone fulls, without any dependencies on the previous backup files.

    SwitchParameter

    False

    Named

    False

    EnablePluginBackupOffload

    Enables offloading of the backup files created with plugin backup jobs to the capacity tier.

    Default:

    • For scale-out backup repositories created with Veeam Backup & Replication versions 10 and earlier: False.
    • For scale-out backup repositories created with Veeam Backup & Replication versions 11 and later: True.

    SwitchParameter

    False

    Named

    False

    EnableCopyAllPluginBackups

    For backup files created with Veeam Plug-in for SAP HANA, Veeam Plug-in for Oracle RMAN.

    Enables copying of all backup files from the performance extents to the capacity extent. If you do not provide this parameter, the cmdlet will not copy these backup files to the capacity extent.

    Note: You must provide the EnableCapacityTierCopyPolicy parameter to activate the copy policy.

    SwitchParameter

    False

    Named

    False

    EnableCopyAllMachineBackups

    For backup files created with Veeam Agent backup jobs and Veeam backup jobs for VMs.

    Enables copying of all backup files from the performance extents to the capacity extent. If you do not provide this parameter, the cmdlet will copy only the latest backup files.

    Note: You must provide the EnableCapacityTierCopyPolicy parameter to activate the copy policy.

    SwitchParameter

    False

    Named

    False

    <CommonParameters>

    This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see the About CommonParameters section of Microsoft Docs.

    Output Object

    The cmdlet returns the VBRScaleOutBackupRepository object.

    Examples

    Creating Scale-Out Repository

    This command creates a scale-out repository. This scale-out repository will be created with the Performance Tier option and the performance policy type.

    Add-VBRScaleOutBackupRepository -Name "Veeam Performance Scale-Out Repository" –PolicyType Performance –Extent “Backup Repository 1”, “Backup Repository 2”

    Creating Scale-Out Repository with Capacity Tier Option

    This example shows how to create a scale-out repository with the capacity tier option.

    1. Run the Get-VBRObjectStorageRepository cmdlet to get the object storage that you want to use for the capacity tier option. Save the result to the $objectstorage variable.
    2. Run the Add-VBRScaleOutBackupRepository cmdlet with the $objectstorage variable. Use the PolicyType parameter to specify the policy type for the scale-out repository.

    $objectstorage = Get-VBRObjectStorageRepository -Name "Amazon S3"

    Add-VBRScaleOutBackupRepository -Name "ScaleOutRepository" -Extent "New repository"  -PolicyType Performance -EnableCapacityTier -ObjectStorageRepository $objectstorage

    Related Commands