Remove-VBRProtectionGroup

In this article

    Short Description

    Removes protection groups.

    Applies to

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

    Syntax

    Remove-VBRProtectionGroup -ProtectionGroup <VBRProtectionGroup[]> [-WhatIf] [-Confirm]  [<CommonParameters>]

    Detailed Description

    This cmdlet removes selected protection groups from the Veeam Backup & Replication database. When you remove a protection group, Veeam Backup & Replication removes Veeam Agents from all computers of this group. You cannot undo this operation. Backups created for protected computers remain in backup repositories.

    Remove-VBRProtectionGroup Note:

    You cannot remove a protection group that is added to a Veeam Agent backup job.

    Currently Veeam PowerShell does not allow you to create or manage Veeam Agent backup jobs, you can do it only with Veeam Backup & Replication UI.

    Parameters

    Parameter

    Description

    Required

    Position

    Accept
    Pipeline
    Input

    Accept
    Wildcard
    Characters

    ProtectionGroup

    Specifies the array of protection groups. The cmdlet will remove these protection groups from Veeam Backup & Replication.

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

    Return Type

    None

    Example 1

    This example shows how to remove a protection group from Veeam Backup & Replication.

    You will need to perform the following steps:

    1. Run Get-VBRProtectionGroup to get protection group you want to remove. Save the result to the $group variable.
    2. Run Remove-VBRProtectionGroup with the $group variable.

    $group = Get-VBRProtectionGroup -Name "Support_East"

    Remove-VBRProtectionGroup -ProtectionGroup $groups

    Example 2

    This example shows how to remove all protection groups with names containing "Support".

    You will need to perform the following steps:

    1. Run Get-VBRProtectionGroup to get protection groups you want to remove. Save the result to the $groups variable.
    2. Run Remove-VBRProtectionGroup with the $groups variable.

    $groups = Get-VBRProtectionGroup -Name *Support*

    Remove-VBRProtectionGroup -ProtectionGroup $groups

    Related Commands

    Get-VBRProtectionGroup

    I want to report a typo

    There is a misspelling right here:

     

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