Help Center
Choose product document...
Veeam Backup & Replication 9.5
PowerShell Reference

Set-VBRTapeGFSMediaPool

Short Description

Modifies GFS media pool.

Applies to

Platform: VMware, Hyper-V

Product Edition: Standard, Enterprise, Enterprise Plus

Syntax

Set-VBRTapeGFSMediaPool -MediaPool <VBRTapeGFSMediaPool> [-Name <string>] [-Description <string>] [-Library <VBRTapeLibrary[]>] [-Medium <VBRTapeMedium[]>] [-MoveFromFreePool] [-EnableEncryption] [-EncryptionKey <VBREncryptionKey>] [-NextLibOffline] [-NextLibDrivesBusy] [-NextLibNoMedia] [-WeeklyOverwritePeriod <int>] [-MonthlyOverwritePeriod <int>] [-QuarterlyOverwritePeriod <int>] [-YearlyOverwritePeriod <int>] [-WeeklyMediaSetPolicy <VBRTapeGFSMediaSetPolicy>] [-MonthlyMediaSetPolicy <VBRTapeGFSMediaSetPolicy>] [-QuarterlyMediaSetPolicy <VBRTapeGFSMediaSetPolicy>] [-YearlyMediaSetPolicy <VBRTapeGFSMediaSetPolicy>] [-PassThru]  [<CommonParameters>]

Detailed Description

This cmdlet modifies GFS media pool.

Parameters

Parameter

Description

Required

Position

Accept
Pipeline
Input

Accept
Wildcard
Characters

MediaPool

Specifies the GFS media pool you want to modify.

Accepts VBRTapeGFSMediaPool type.

True

Named

True (by Value
FromPipeline, ValueFromPipeline
ByPropertyName)

False

Name

Specifies the name you want to assign to the media pool.

True

Named

False

False

Library

Specifies the array of tape  libraries. The media pool will use tapes from these libraries.

For tape library failover, use NextLibOffline, NextLibDrivesBusy and/or NextLibNoMedia parameters to manage the failover events. Veeam will switch to the next library in order they are added to the VBRTapeLibrary object.

Accepts VBRTapeLibrary, GUID or string type.

True

Named

True (by Value
FromPipeline, ValueFromPipeline
ByPropertyName)

False

Description

Specifies the description for the created media pool.

If not set, Veeam will enter date and time of creation by default.

False

Named

False

False

Medium

Specifies the array of tapes. The cmdlet will add these tapes to the media pool.

Accepts  VBRTapeMedium, GUID or string type.

False

Named

False

False

MoveFrom
FreePool

If set, the media pool will be replenished by tapes from the Free media pool.

False

Named

False

False

Enable
Encryption

Indicates that Veeam Backup & Replication will encrypt data archived to tape.

Use the EncryptionKey parameter to specify the encryption key you want to use to encrypt the data.

False

Named

False

False

EncryptionKey

Used to set the encryption key for the EnableEncryption parameter.

Specifies the encryption key you want to use to encrypt the data.

Accepts VBREncryptionKey type.

False

Named

False

False

NextLib
Offline

If set, the media pool will switch to the next library if the primary library is offline.

Default: true.

False

Named

False

False

NextLib
DrivesBusy

If set, the media pool will switch to the next library if the primary library has no available drives.

Default: true.

False

Named

False

False

NextLib
NoMedia

If set, the media pool will switch to the next library if the primary library has no available media.

Default: true.

False

Named

False

False

Weekly
Overwrite
Period

Indicates the data retention period for the weekly media set (weeks).

False

Named

False

False

Monthly
Overwrite
Period

Indicates the data retention period for the monthly media set (months).

False

Named

False

False

Quarterly
Overwrite
Period

Indicates the data retention period for the quarterly media set (months).

False

Named

False

False

Yearly
Overwrite
Period

Indicates the data retention period for the yearly media set (years).

False

Named

False

False

Weekly
MediaSet
Policy

Indicates settings for the weekly media set.

Accepts VBRTapeGFSMediaSetPolicy type.

False

Named

False

False

Monthly
MediaSet
Policy

Indicates settings for the monthly media set.

Accepts VBRTapeGFSMediaSetPolicy type.

False

Named

False

False

Quarterly
MediaSet
Policy

Indicates settings for the quarterly media set.

Accepts VBRTapeGFSMediaSetPolicy type.

False

Named

False

False

Yearly
MediaSet
Policy

Indicates settings for the yearly media set.

Accepts VBRTapeGFSMediaSetPolicy type.

False

Named

False

False

PassThru

Indicates that the command returns the output object to the Windows PowerShell console.

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.

Return Type

VBRTapeGFSMediaPool

Related Commands

Get-VBRTapeLibrary

Get-VBREncryptionKey

New-VBRTapeGFSMediaSetPolicy

Veeam Large Logo

User Guide for VMware vSphere

User Guide for Microsoft Hyper-V

Enterprise Manager User Guide

Veeam Cloud Connect Guide

Veeam Backup Explorers User Guide

PowerShell Reference

RESTful API Reference

Veeam Backup FREE Edition User Guide

Veeam Backup for Microsoft Office 365

Veeam ONE Documentation

Veeam Agent for Windows Documentation

Veeam Agent for Linux Documentation

Veeam Management Pack Documentation