Help Center
Choose product document...
Veeam Backup & Replication 9.5
PowerShell Reference

Move-VBRTapeMedium

Short Description

Moves tape to media pool or vault.

Applies to

Platform: VMware, Hyper-V

Product Edition: Standard, Enterprise, Enterprise Plus

Syntax

This cmdlet provides 2 parameter sets.

  • For moving tapes to another media pool:

Move-VBRTapeMedium -Medium <VBRTapeMedium[]> -MediaPool <VBRTapeMediaPool> [-WhatIf] [-Confirm] [<CommonParameters>]

  • For moving tapes to vault:

Move-VBRTapeMedium -Medium <VBRTapeMedium[]> -Vault <VBRTapeVault> [-WhatIf] [-Confirm] [<CommonParameters>]

Detailed Description

This cmdlet moves selected tapes to another media pool or media vault.

Move-VBRTapeMedium Important!

When you move a tape to any media pool, Veeam Backup & Replication marks this tape as free.

You can configure automatic moving offline tapes to a vault in the media pool settings. Run Set-VBRTapeMediaPool to edit media pool configuration.

Parameters

Parameter

Description

Required

Position

Accept
Pipeline
Input

Accept
Wildcard
Characters

Medium

Specifies the array of tapes you want to move.

Accepts VBRTapeMedium, GUID or string type.

True

Named

True (by Value
FromPipeline, ValueFromPipeline
ByPropertyName)

False

MediaPool

Specifies the media pool to which you want to move the tapes.

Accepts VBRTapeMediaPool, GUID or string type.

True

Named

False

False

Vault

Specifies the media vault to which you want to move the tapes.

Accepts VBRTapeVault, GUID or string type.

True

Named

False

False

WhatIf

Specifies whether the cmdlet writes a message that describes the effects of running the cmdlet without actually performing any action.

False

Named

False

False

Confirm

Specifies whether the cmdlet displays a prompt that asks if the user is sure that they want to continue.

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.

Return Type

None

Example 1

This example shows how to move a tape to a media pool.

  1. Get the target media pool. Run Get-VBRTapeMediaPool and save it to the $mediapool variable.
  2. Get the tape you want to move. Run Get-VBRTapeMedium and pipe it to Move-VBRTapeMedium. Use the $mediapool variable.

PS C:\PS> Get-VBRTapeMedium -Name 0014001H | Move-VBRTapeMedium -MediaPool $mediapool

Example 2

This example shows how to move a tape to a vault.

  1. Get the tape you want to move. Run Get-VBRTapeMedium and save the result to the '$medium' variable.
  2. Get the target vault. Run Get-VBRTapeVault and save it to the $vault variable.
  3. Run Move-VBRTapeMedium with the saved variables.

PS C:\PS> Move-VBRTapeMedium -Medium $medium -Vault $vault

Related Commands

Get-VBRTapeMedium

Get-VBRTapeMediaPool

Get-VBRTapeVault

Veeam Large Logo

User Guide for VMware vSphere

User Guide for Microsoft Hyper-V

Enterprise Manager User Guide

Veeam Cloud Connect Guide

Veeam Backup Explorers User Guide

PowerShell Reference

RESTful API Reference

Veeam Backup FREE Edition User Guide

Veeam Backup for Microsoft Office 365

Veeam ONE Documentation

Veeam Endpoint Backup Documentation

Veeam Management Pack Documentation