Add-VBRTapeMediaPool

Name

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

String

True

Named

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 the VBRTapeLibrary object, GUID or string. To get this object, run the Get-VBRTapeLibrary cmdlet.

True

Named

True (ByValue,
ByProperty
Name)

Description

Specifies the description for the created media pool.

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

String

False

Named

False

Medium

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

Accepts the VBRTapeMedium[] object, GUID or string. To get this object, run the Get-VBRTapeMedium cmdlet.

False

Named

False

MoveFromFreePool

Defines that the media pool will be replenished by tapes from the Free media pool.

SwitchParameter

False

Named

False

MoveOfflineToVault

Defines that the tapes that go offline must be automatically moved to a vault.

Use the Vault parameter to specify the vault to which you want to move the tapes from this media pool.

SwitchParameter

False

Named

False

Vault

Used to set vault for the MoveOfflineToVault parameter.

Specifies the vault to which you want to automatically move the tapes. You can use one vault for several media pools.

Accepts the VBRTapeVault cmdlet, GUID or string. To get this object, run the Get-VBRTapeVault cmdlet.

False

Named

False

EnableEncryption

Enables encryption for the data archived to tape.

Use the EncryptionKey or KMSServer parameters to specify the encryption key you want to use to encrypt the data.

SwitchParameter

False

Named

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 the VBREncryptionKey object. To get this object, run the Get-VBREncryptionKey cmdlet.

False

Named

False

KMSServer

Used to set the encryption key for the EnableEncryption parameter if you use the KMS Server for encryption.

Specifies the KMS Server you want to use to encrypt the data.

Accepts the VBRKMSServer object. To get this object, run the Get-VBRKMSServer cmdlet.

False

Named

False

MediaSetCreationPolicy

Specifies the settings of media set you want to apply to this media pool.

If you omit this parameter, the media creation policy will be set to Never by default.

Accepts the VBRTapeMediaSetCreationPolicy object. To create this object, run the New-VBRTapeMediaSetCreationPolicy cmdlet.

False

Named

False

MediaSetName

Specifies the new name you want to assign to the media sets created in this media pool.

If you omit this parameter, the media set name will be set to Media set %date% by default.

String

False

Named

False

RetentionPolicy

Specifies the retention settings you want to apply to this media pool.

If you omit this parameter, the media set name will be set to Never by default.

Note: This parameter will not work in case you use the WORM parameter.

Accepts the VBRTapeMediaPoolRetentionPolicy object. To get this object, run the  cmdlet.

False

Named

False

NextLibOffline

Defines that the media pool will switch to the next library if the primary library is offline.

Default: True.

Note: To disable this option, set the parameter value to $false. That is, parameter_name:$false.

SwitchParameter

False

Named

False

NextLibDrivesBusy

Defines that the media pool will switch to the next library if the primary library has no available drives.

Default: True.

Note: To disable this option, set the parameter value to $false. That is, parameter_name:$false.

SwitchParameter

False

Named

False

NextLibNoMedia

Defines that the media pool will switch to the next library if the primary library has no available media.

Default: True.

Note: To disable this option, set the parameter value to $false. That is, parameter_name:$false.

SwitchParameter

False

Named

False

EnableMultiStreaming

Enables the media pool to 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.

SwitchParameter

False

Named

False

SplitJobFilesBetweenDrives

Defines that 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.

SwitchParameter

False

Named

False

NumberOfStreams

Used to set value for the EnableMultiStreaming parameter.

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

Default: 2.

Int32

False

Named

False

WORM

Defines that the cmdlet will add the WORM Media Pool.

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

Default: False.

SwitchParameter

False

Named

False