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

Set-VBRTapeGFSMediaPool

In this article

    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>]

    Related Commands

    Get-VBRTapeLibrary

    Get-VBREncryptionKey

    New-VBRTapeGFSMediaSetPolicy

    Return Type

    VBRTapeGFSMediaPool

    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.

    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 tape library, or a number of libraries, whose tapes will be used in this media pool.

    You can add several libraries and use them to switch to another library in case the primary library is offline, has no available drives or no available tapes. Use the NextLibOffline, NextLibDrivesBusy and/or NextLibNoMedia parameters to manage the libraries.

    You can assign multiple tapes to this object. Veeam will switch to the nest library in order they are added to the VBRTapeLibrary object.

    Accepts VBRTapeLibrary object, 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 tape(s) you want to add to the media pool.

    You can assign multiple tapes to this object.

    Accepts  VBRTapeMedium  object, 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.

    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.

    Accepts Int values (weeks).

    False

    Named

    False

    False

    Monthly
    Overwrite
    Period

    Indicates the data retention period for the monthly media set.

    Accepts Int values (months).

    False

    Named

    False

    False

    Quarterly
    Overwrite
    Period

    Indicates the data retention period for the quarterly media set.

    Accepts Int values (months).

    False

    Named

    False

    False

    Yearly
    Overwrite
    Period

    Indicates the data retention period for the yearly media set.

    Accepts Int values (years).

    False

    Named

    False

    False

    Weekly
    MediaSet
    Policy

    Indicates settings for the weekly media set.

    Accepts VBRTapeGFSMediaSetPolicy object.

    False

    Named

    False

    False

    Monthly
    MediaSet
    Policy

    Indicates settings for the monthly media set.

    Accepts VBRTapeGFSMediaSetPolicy object.

    False

    Named

    False

    False

    Quarterly
    MediaSet
    Policy

    Indicates settings for the quarterly media set.

    Accepts VBRTapeGFSMediaSetPolicy object.

    False

    Named

    False

    False

    Yearly
    MediaSet
    Policy

    Indicates settings for the yearly media set.

    Accepts VBRTapeGFSMediaSetPolicy object.

    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.