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

Add-VBRTapeGFSMediaPool

Short Description

Creates a new GFS media pool.

Applies to

Platform: VMware, Hyper-V

Product Edition: Enterprise, Enterprise Plus

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
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
DailyOverwritePeriod	Indicates the data retention period for the daily media set (days).	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
DailyMediaSetPolicy	Indicates settings for the daily media set. Accepts VBRTapeGFSMediaSetPolicy type.	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
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

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