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

Remove-VBRTapeMediaPool

In this article

    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

    <CommonParameters>

    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