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

Remove-VBRTapeMediaPool

On This Page

Short Description
Applies to
Syntax
Return Type
Detailed Description
Parameters
Example 1
Example 2

Short Description

Removes media pool.

Applies to

Platform: VMware, Hyper-V

Product Edition: Standard, Enterprise, Enterprise Plus

Syntax

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

Related Commands

Get-VBRTapeMediaPool

Return Type

None

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 media pool(s) you want to remove. You can assign multiple media pools to this object. Accepts VBRTapeMediaPool object, GUID or string type.	True	Named	True (by Value FromPipeline, ValueFromPipeline ByPropertyName)	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

This cmdlet supports Microsoft PowerShell common parameters. For more information about common parameters, see http://go.microsoft.com/fwlink/p/?LinkID=113216.

Example 1

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

PS C:\PS> 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.

PS C:\PS> Remove-VBRTapeMediaPool -MediaPool $pool