New-VBRTapeGFSMediaSetPolicy

Short Description

Creates a new VBRTapeGFSMediaSetPolicy object.

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

Parameters
Parameter	Description	Type	Required	Position	Accept Pipeline Input
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
Medium	Specifies the array of tapes. The cmdlet will add these tapes to the media set. Accepts the `VBRTapeMedium` object, GUID or string.	`VBRTapeMedium[]`	False	Named	True (ByPropertyName, ByValue)
MoveFromMediaPoolAutomatically	Defines that the media set will be replenished by tapes from the parent 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 set.	`SwitchParameter`	False	Named	False
Name	Specifies the name that must be used for creating media set.	`String`	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.	`VBRTapeVault`	False	Named	False

<CommonParameters>

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.