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

Remove-VBRBackupRepository

In this article

    Short Description

    Removes a specified backup repository from Veeam Backup & Replication.

    Applies to

    Platform: VMware

    Product Edition: Standard, Enterprise, Enterprise Plus

    Syntax

    Remove-VBRBackupRepository -Repository <CBackupRepository[]> [-WarningAction <ActionPreference>] [-WarningVariable <String>] [-WhatIf] [-Confirm] [<CommonParameters>]

    Related Commands

    Get-VBRBackup

    Detailed Description

    This cmdlet allows you to remove the specified backup repository from Veeam Backup & Replication.

    When you remove a backup repository, Veeam Backup & Replication unassigns the repository role from the server, so it is no longer used as a backup destination. The actual server remains connected to Veeam Backup & Replication.

    Parameters

    Parameter

    Description

    Required

    Position

    Accept
    Pipeline
    Input

    Accept
    Wildcard
    Characters

    Repository

    Specifies the backup repository you want to remove.

    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 about common parameters, see http://go.microsoft.com/fwlink/p/?LinkID=113216.

    Example 1

    This command removes the backup repository named "Local Repository 01". The repository is obtained with Get-VBRBackupRepository and piped down.

    Get-VBRBackupRepository -Name "Local Repository 01" | Remove-VBRBackupRepository

    Example 2

    This command removes the backup repository represented by the $repository variable. The repository is obtained with Get-VBRBackupRepository and assigned to the variable beforehand.

    Remove-VBRBackupRepository -Repository $repository