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

Set-VBRTapeMediaPool

On This Page

Short Description
Applies to
Syntax
Return Type
Detailed Description
Parameters
Example 1
Example 2

Short Description

Modifies media pool.

Applies to

Platform: VMware, Hyper-V

Product Edition: Standard, Enterprise, Enterprise Plus

Syntax

Set-VBRTapeMediaPool -MediaPool <VBRTapeMediaPool> -Library <VBRTapeLibrary[]> [-Name <string>] [-Description <string>] [-MoveFromFreePool] [-MoveOfflineToVault] [-Vault <VBRTapeVault>] [-EnableEncryption] [-EncryptionKey <VBREncryptionKey>] [-MediaSetCreationPolicy <VBRTapeMediaSetCreationPolicy>] [-MediaSetName <string>] [-RetentionPolicy <VBRTapeMediaPoolRetentionPolicy>] [-NextLibOffline] [-NextLibDrivesBusy] [-NextLibNoMedia] [-EnableMultiStreaming] [-NumberOfStreams <int>] [-SplitJobFilesBetweenDrives] [-PassThru] [<CommonParameters>]

Related Commands

New-VBRTapeMediaPoolRetentionPolicy

New-VBRTapeMediaSetCreationPolicy

Return Type

VBRTapeMediaPool

Detailed Description

This cmdlet modifies media pool that was created before. To modify settings, you need to enter the corresponding parameters with new values. The parameters that you omit will remain unchanged.

Parameters

Parameter	Description	Required	Position	Accept Pipeline Input	Accept Wildcard Characters
MediaPool	Specifies the media pool you want to modify.	True	Named	True (by Value FromPipeline, ValueFromPipeline ByPropertyName)	False
Name	Specifies the new 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.	False	Named	True (by ValueFromPipeline ByPropertyName)	False
Description	Specifies the description for the media pool.	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
MoveOffline ToVault	Indicates 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.	False	Named	False	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 VBRTapeVault object, GUID or string type.	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
Encryption Key	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
MediaSet Creation Policy	Specifies the settings of media set you want to apply to this media pool. If omitted, the media creation policy will be set to 'Never' by default. Accepts VBRTapeMediaSetCreationPolicy object.	False	Named	False	False
MediaSet Name	Specifies the new name you want to assign to the media sets created in this media pool. If omitted, the media set name will be set to "Media set %date%” by default. Accepts string type.	False	Named	False	False
Retention Policy	Specifies the retention settings you want to apply to this media pool. If omitted, the media set name will be set to 'Never' by default. Accepts VBRTapeMediaPoolRetentionPolicy object.	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
Enable MultiStreaming	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.	False	Named	False	False
SplitJobFiles BetweenDrives	If set, the backup files within one backup set will be written with several drives to several tapes. Otherwise, one tape job will use one drive.	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
PassThru	Indicates that the command returns the output object to the Windows PowerShell console.	False	Named	False	False

This cmdlet supports Microsoft PowerShell common parameters. For more information about common parameters, see http://go.microsoft.com/fwlink/p/?LinkID=113216.

Example 1

This command instructs a selected media pool to move the offline tapes to a tape vault.

Run Get-VBRTapeMediaPool to get the media pool. Save it to the $mediapool variable.
Run Get-VBRTapeLibrary to get the library. Save it to the $library variable.
Run Get-VBRTapeVault to get the target vault. Save it to the $vault variable.
Run Set-VBRTapeMediaPool with the saved variables. Use the MoveOfflineToVault parameter to instruct the media pool to move the offline tapes to a vault.

PS C:\PS> Set-VBRTapeMediaPool -MediaPool $mediapool -Library $library -MoveOfflineToVault -Vault $vault

Example 2

This command adds encryption settings to a selected media pool.

Run Get-VBRTapeMediaPool to get the media pool. Save it to the $mediapool variable.
Run Get-VBRTapeLibrary to get the library. Save it to the $library variable.
Run Get-VBREncryptionKey to get the encryption key. Save it to the $encryptionkey variable.
Run Set-VBRTapeMediaPool with the saved variables. Use the EnableEncryption parameter to instruct the media pool to encrypt the archived data.

PS C:\PS> Set-VBRTapeMediaPool -MediaPool $mediapool -Library $library -EnableEncryption -EncryptionKey $encryptionkey