Add-VBRTapeGFSMediaPool

In this article

    Short Description

    Creates a new GFS media pool.

    Applies to

    Platform: VMware, Hyper-V

    Product Edition: Enterprise, Enterprise Plus, Veeam Universal License

    Syntax

    Add-VBRTapeGFSMediaPool -Name <string> -Library <VBRTapeLibrary[]> [-Description <string>] [-Medium <VBRTapeMedium[]>] [-MoveFromFreePool] [-EnableEncryption] [-EncryptionKey <VBREncryptionKey>] [-NextLibOffline] [-NextLibDrivesBusy] [-NextLibNoMedia] [-DailyOverwritePeriod <int>] [-WeeklyOverwritePeriod <int>] [-MonthlyOverwritePeriod <int>] [-QuarterlyOverwritePeriod <int>] [-YearlyOverwritePeriod <int>] [-DailyMediaSetPolicy <VBRTapeGFSMediaSetPolicy>] [-WeeklyMediaSetPolicy <VBRTapeGFSMediaSetPolicy>] [-MonthlyMediaSetPolicy <VBRTapeGFSMediaSetPolicy>] [-QuarterlyMediaSetPolicy <VBRTapeGFSMediaSetPolicy>] [-YearlyMediaSetPolicy <VBRTapeGFSMediaSetPolicy>] [-EnableMultiStreaming][-SplitJobFilesBetweenDrives] [-NumberOfStreams <int>] [-WORM]  [<CommonParameters>]

    Detailed Description

    This cmdlet creates a new GFS media pool. The media sets are created with default settings.

    Run New-VBRTapeGFSMediaSetPolicy to set other options for media sets.

    Parameters

    Parameter

    Description

    Required

    Position

    Accept
    Pipeline
    Input

    Accept
    Wildcard
    Characters

    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 (ByValue,
    ByProperty
    Name)

    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

    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

    MoveFromFreePool

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

    False

    Named

    False

    False

    EnableEncryption

    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

    NextLibOffline

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

    Default: true.

    False

    Named

    False

    False

    NextLibDrivesBusy

    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

    NextLibNoMedia

    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

    DailyOverwritePeriod

    Indicates the data retention period for the daily media set (days).

    False

    Named

    False

    False

    WeeklyOverwritePeriod

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

    False

    Named

    False

    False

    MonthlyOverwritePeriod

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

    False

    Named

    False

    False

    QuarterlyOverwritePeriod

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

    False

    Named

    False

    False

    YearlyOverwritePeriod

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

    False

    Named

    False

    False

    DailyMediaSetPolicy

    Indicates settings for the daily media set.

    Accepts VBRTapeGFSMediaSetPolicy type.

    False

    Named

    False

    False

    WeeklyMediaSetPolicy

    Indicates settings for the weekly media set.

    Accepts VBRTapeGFSMediaSetPolicy type.

    False

    Named

    False

    False

    MonthlyMediaSetPolicy

    Indicates settings for the monthly media set.

    Accepts VBRTapeGFSMediaSetPolicy type.

    False

    Named

    False

    False

    QuarterlyMediaSetPolicy

    Indicates settings for the quarterly media set.

    Accepts VBRTapeGFSMediaSetPolicy type.

    False

    Named

    False

    False

    YearlyMediaSetPolicy

    Indicates settings for the yearly media set.

    Accepts VBRTapeGFSMediaSetPolicy type.

    False

    Named

    False

    False

    EnableMultiStreaming

    Indicates that the media pool can use several drives simultaneously.

    Use the NumberOfStreams parameter to set the maximum number of drives that can be used.

    Use the SplitJobFilesBetweenDrives parameter to indicate if the multistreaming will be used to split data between tape jobs or between source backup jobs.

    False

    Named

    False

    False

    SplitJobFilesBetweenDrives

    If set, one tape job will use multiple drives to write data. Drives will process source backup jobs one by one.

    Default: one drive is used for one tape job.

    False

    Named

    False

    False

    NumberOfStreams

    Used to set value for the EnableMultiStreaming parameter.

    Indicates the maximum number of drives that the media pool can use.

    Default: 2.

    False

    Named

    False

    False

    WORM

    If set, the cmdlet will add the WORM Media Pool.

    NOTE: you cannot set retention policy when the WORM parameter is set to true.

    Default: false.

    False

    Named

    False

    False

    <CommonParameters>

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

    Return Type

    VBRTapeGFSMediaPool

    Related Commands

    Get-VBRTapeLibrary

    Get-VBREncryptionKey

    New-VBRTapeGFSMediaSetPolicy