Remove-VBRTapeMediaPool

In this article

    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

    <CommonParameters>

    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

    I want to report a typo

    There is a misspelling right here:

     

    I want to let the Veeam Documentation Team know about that.