Add-VBRTapeMediaPool
Short Description
Creates a new media pool.
Applies to
Platform: VMware, Hyper-V
Product Edition: Standard, Enterprise, Enterprise Plus
Syntax
Add-VBRTapeMediaPool -Name <string> -Library <VBRTapeLibrary[]> [-Description <string>] [-Medium <VBRTapeMedium[]>] [-MoveFromFreePool] [-MoveOfflineToVault] [-Vault <VBRTapeVault>] [-EnableEncryption] [-EncryptionKey <VBREncryptionKey>] [-MediaSetCreationPolicy <VBRTapeMediaSetCreationPolicy>] [-MediaSetName <string>] [-RetentionPolicy <VBRTapeMediaPoolRetentionPolicy>] [-NextLibOffline] [-NextLibDrivesBusy] [-NextLibNoMedia] [-EnableMultiStreaming] [-SplitJobFilesBetweenDrives] [-NumberOfStreams <int>] [<CommonParameters>] |
Related Commands
New-VBRTapeMediaPoolRetentionPolicy
New-VBRTapeMediaSetCreationPolicy
Return Type
Detailed Description
This cmdlet creates a new custom media pool.
Run Add-VBRTapeGFSMediaPool to create a GFS media pool.
Parameters
Parameter | Description | Required | Position | Accept | Accept |
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 | 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 | If set, the media pool will be replenished by tapes from the Free media pool. | False | Named | False | False |
MoveOffline | 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 | 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 | 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 | 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 | 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 | 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 |
NextLib | If set, the media pool will switch to the next library if the primary library is offline. Default: true. | False | Named | False | False |
NextLib | 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 | 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 | 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 |
SplitJobFiles | If set, one tape job will use multiple drives to write data. Drives will process source backup jobs one by one. Otherwise, one drive will be 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 |
<CommonParameters>
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 creates a media pool with default settings.
Get the library in which the media pool is created with Get-VBRTapeLibrary and pipe it to Add-VBRTapeMediaPool.
PS C:\PS> Get-VBRTapeLibrary -Name "HP MSL G3 Series 3.00" | Add-VBRTapeMediaPool -Name "Monthly Full Backups" -MoveFromFreePool |
Example 2
This command creates a media pool with the following settings:
- Offline tape are moved to vault.
- Data on tape is encrypted.
To create the media pool:
- Preconfigure media set creation policy. For details, see New-VBRTapeMediaSetCreationPolicy. Save the result to the $mediasetpolicy variable.
- Preconfigure retention policy. For details, see New-VBRTapeMediaPoolRetentionPolicy. Save the result to the $retentionpolicy variable.
- Run Get-VBRTapeLibrary to get the tape library. Save the result to the $library variable.
- Run Get-VBRTapeMedium to select tapes to add to the media pool. Save the array to the $media variable.
- Run Get-VBRTapeVault to get the vault for offline tapes. Save the result to the $vault variable.
- Run Get-VBREncryptionKey to get the encryption key. Save the result to the $securepassword variable.
- Run Add-VBRTapeMediaPool with the saved variables.
PS C:\PS> Add-VBRTapeMediaPool -Name "AD Backups Encrypted" -Description "Active Directory Encrypted Backups" -Library $library -Medium $media -MoveOfflineToVault -Vault $vault -EnableEncryption -EncryptionKey $securepassword -MediaSetCreationPolicy $mediasetpolicy -MediaSetName "AD Daily %date%" -RetentionPolicy $retentionpolicy |