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 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

<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:

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

Related Commands