Set-VBRRepositoryExtent

Short Description

Modifies performance extents of scale-out backup repositories.

Applies to

Platform: VMware, Hyper-V

Product Edition: Enterprise, Enterprise Plus, Veeam Universal License

Syntax

Set-VBRRepositoryExtent -Extent <VBRRepositoryExtent[]> [-StoreFull] [-StoreIncrement] [-Data] [-Metadata]  [<CommonParameters>]

Detailed Description

This cmdlet modifies performance extents of a scale-out repository. You can change the backup placement mode for a selected extents to store only full backups, only incremental backups or full and incremental backups. By default, the extents are created with full and incremental backups placement mode.

Important

You cannot modify parameters of object storage performance extents using this cmdlet.

Note

To modify settings, specify new values for the necessary parameters. The cmdlet will overwrite the previous parameters values with new values. The parameters that you omit will remain unchanged.

Parameters

Parameter

Description

Type

Required

Position

Accept
Pipeline
Input

Extent

Specifies the array of extents you want to modify.

All extents must belong to the same scale-out repository.

Accepts the following object:

To get one of these object, run the Get-VBRRepositoryExtent cmdlet.

True

Named

True (ByValue,
ByProperty
Name)

StoreFull

For extents with Performance policy.

Defines that the extent will store only full backups.

SwitchParameter

False

Named

True (ByProperty
Name)

StoreIncrement

For extents with Performance policy.

Defines that the extent will store only incremental backups.

SwitchParameter

False

Named

True (ByProperty
Name)

Data

Defines that the extent will store only backup data.

This parameter can be used together with the Metadata parameter.

For more information, see the Scale-Out Repository with Extents in Metadata and Data Roles section in the Veeam Backup & Replication User Guide.

SwitchParameter

False

Named

True (ByValue,
ByProperty
Name)

Metadata

Defines that the extent will store only backup metadata.

Note: an extent with the metadata role can be used for storing NAS backup jobs metadata only.

This parameter can be used together with the Data parameter.

For more information, see the Scale-Out Repository with Extents in Metadata and Data Roles section in the Veeam Backup & Replication User Guide.

SwitchParameter

False

Named

True (ByValue,
ByProperty
Name)

<CommonParameters>

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see Microsoft Docs.

Output Object

The cmdlet returns one of the following objects:

Examples

Set-VBRRepositoryExtentExample 1. Changing Storing Mode to Store Only Full Backups

This command changes the storing mode to store only full backups for the extent named Backup Repository 1.

Set-VBRRepositoryExtent –Extent “Backup Repository 1” –StoreFull

Set-VBRRepositoryExtentExample 2. Enabling Storing Full and Incremental Backups

This command enables storing of full and incremental backups on extents Backup Repository 1 and Backup Repository 4.

Set-VBRRepositoryExtent –Extent “Backup Repository 1”, “Backup Repository 4” –StoreFull –StoreIncrement

Set-VBRRepositoryExtentExample 3. Assigning Metadata and Data Roles

These commands enable assigning the metadata role to extent NAS Backup Repository on SSD and data role to extent Backup Repository 1.

Set-VBRRepositoryExtent –Extent “NAS Backup Repository on SSD” -Metadata

Set-VBRRepositoryExtent –Extent “Backup Repository 1” –Data

Related Commands

Get-VBRRepositoryExtent