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

Set-VBRRepositoryExtent

Short Description

Modifies extents of scale-out backup repositories.

Applies to

Platform: VMware, Hyper-V

Product Edition: Standard, Enterprise, Enterprise Plus

Syntax

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

Related Commands

Get-VBRRepositoryExtent

Return Type

VBRDataLocalityExtent or VBRPerformanceExtent

Detailed Description

This cmdlet modifies selected extents of a scale-out repository. You can change the backup placement mode for a selected extent(s) 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.

Parameters

Parameter

Description

Required

Position

Accept
Pipeline
Input

Accept
Wildcard
Characters

Extent

Specifies the extent you want to modify.

Accepts VBRDataLocalityExtent or VBRPerformanceExtent object, GUID or string (name of the backup repository that is used as extent).

You can list multiple extents. All extents must belong to the same scale-out repository.

True

Named

True (by Value
FromPipeline, ValueFromPipeline
ByPropertyName)

False

StoreFull

Used for extents with the Performance policy.

If indicated, the extent will store only full backups.

Default: False.

False

Named

True (by ValueFromPipeline
ByPropertyName)

False

StoreIncrement

Used for extents with the Performance policy.

If indicated, the extent will store only incremental backups.

Default: False.

False

Named

True (by ValueFromPipeline
ByPropertyName)

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 changes the storing mode to store only full backups for the extent named "Backup Repository 1".

PS C:\PS> Set-VBRRepositoryExtent –Extent “Backup Repository 1” –StoreFull

Example 2

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

PS C:\PS> Set-VBRRepositoryExtent –Extent “Backup Repository 1”, “Backup Repository 4” –StoreFull –StoreIncrement