New-VBRTapeGFSMediaSetPolicy

Short Description

Creates a new VBRTapeGFSMediaSetPolicy object.

Applies to

Platform: VMware, Hyper-V

Product Edition: Standard, Enterprise, Enterprise Plus, Veeam Universal License

Syntax

New-VBRTapeGFSMediaSetPolicy [-Medium <VBRTapeMedium[]>] [-MoveFromMediaPoolAutomatically] [-Name <string>] [-AppendToCurrentTape] [-MoveOfflineToVault] [-Vault <VBRTapeVault>] [<CommonParameters>]

Detailed Description

This cmdlet creates a new VBRTapeGFSMediaSetPolicy object. This object contains advanced GFS media set options and is used to apply these options to a GFS media pool.

Parameters

Parameter	Description	Type	Required	Position	Accept Pipeline Input
Medium	Specifies the array of tapes. The cmdlet will add these tapes to the media set.	Accepts the VBRTapeMedium object, GUID or string.	False	Named	False
MoveFromMediaPoolAutomatically	Defines that the media set will be replenished by tapes from the parent media pool.	SwitchParameter	False	Named	False
Name	Specifies the name that must be used for creating media set.	String	False	Named	False
AppendToCurrentTape	Defines if the new data is appended to the tape with previously written data. If you set it to false, a new tape is used for each backup set.	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 set.	SwitchParameter	False	Named	False
Vault	Used to set the 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 object, GUID or string.	False	Named	False

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see Microsoft Docs.

Output Object

VBRTapeGFSMediaSetPolicy

Examples

Creating Policy to Append Data to Current Tape and Move Offline Tapes to Vault

This example shows how to create a GFS media set policy with advanced settings. After you apply the policy to a GFS media set, it will append new data to the current tape and move offline tapes to the Sydney Remote Storage vault.

$vault = Get-VBRTapeVault -Name "Sydney Remote Storage"

New-VBRTapeGFSMediaSetPolicy -AppendToCurrentTape -MoveOfflineToVault -Vault $vault

Perform the following steps:

Run the Get-VBRTapeVault cmdlet. Specify the Name parameter value. Save the result to the $vault variable.
Run the New-VBRTapeGFSMediaSetPolicy cmdlet. Provide the AppendToCurrentTape parameter. Provide the MoveOfflineToVault parameter. Set the $vault variable as the Vault parameter value.

Related Commands