This is an archive version of the document. To get the most up-to-date information, see the current version.

Remove-VBRTapeMediaPool

Short Description

Removes media pool.

Applies to

Platform: VMware, Hyper-V

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

Syntax

Remove-VBRTapeMediaPool -MediaPool <VBRTapeMediaPool[]> [-WhatIf] [-Confirm] [<CommonParameters>]

Detailed Description

This cmdlet removes a selected media pool from Veeam Backup & Replication.

Remove-VBRTapeMediaPool Important!

Removing media pools has the following restrictions:

You can only delete custom media pools; predefined media pools cannot be deleted.
You cannot delete a media pool that contains tapes. To be able to delete such a pool, first move tapes from this pool to other media pools.
You cannot delete media pools used by an existing backup/files to tape copy job. In case you definitely have to disable this pool, you should first modify the corresponding job to target another media pool.

Parameters

Parameter	Description	Required	Position	Accept Pipeline Input	Accept Wildcard Characters
MediaPool	Specifies the array of media pools. The cmdlet will remove these media pools. Accepts VBRTapeMediaPool, GUID or string type.	True	Named	True (ByValue, ByProperty Name)	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

Parameter

Description

Required

Position

Accept
Pipeline
Input

Accept
Wildcard
Characters

MediaPool

Specifies the array of media pools. The cmdlet will remove these media pools.

Accepts VBRTapeMediaPool, GUID or string type.

True

Named

True (ByValue,
ByProperty
Name)

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

Confirm

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

False

Named

False

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see the About CommonParameters section of Microsoft Docs.

Return Type

None

Example 1

This command removes the media pool named "Winserver MediaPool". The media pool is obtained with Get-VBRTapeMediaPool and piped down.

Get-VBRTapeMediaPool -Name "Winserver MediaPool" | Remove-VBRTapeMediaPool

Example 2

This command removes the media pool represented by the $pool variable. The media pool is obtained with Get-VBRTapeMediaPool and assigned to $pool variable beforehand.

Remove-VBRTapeMediaPool -MediaPool $pool

Related Commands

Get-VBRTapeMediaPool