Remove-VBRHvProxy

In this article

    Short Description

    Removes a specified Hyper-V backup proxy from Veeam Backup & Replication.  

    Applies to

    Platform: Hyper-V

    For VMware, run Remove-VBRViProxy.

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

    Syntax

    Remove-VBRHvProxy -Proxy <CHvProxy[]> [-WarningAction <ActionPreference>] [-WarningVariable <String>] [-WhatIf] [-Confirm] [<CommonParameters>]

    Detailed Description

    This cmdlet allows you to remove the specified Hyper-V backup proxy from Veeam Backup & Replication.

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

    Remove-VBRHvProxy Note:

    You cannot remove a backup proxy that is explicitly selected in any backup, replication or VM copy job. To remove such a proxy, you need to delete all job references to it first.

    Run Disable-VBRHvProxy to disable a Hyper-V proxy.

    Parameters

    Parameter

    Description

    Required

    Position

    Accept
    Pipeline
    Input

    Accept
    Wildcard
    Characters

    Proxy

    Specifies the array of Hyper-V proxies 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 on common parameters, see the About CommonParameters section of Microsoft Docs.

    .Example 1

    This command removes the proxies named "Proxy 01" and "Proxy 03". The proxies are obtained with Get-VBRHvProxy and piped down.

    Get-VBRHvProxy -Name "Proxy 01", "Proxy 03"| Remove-VBRHvProxy

    Example 2

    This command removes the proxy represented by the $proxy variable. The proxy is obtained with Get-VBRHvProxy and assigned to the variable beforehand.

    Remove-VBRHvProxy -Proxy $proxy

    Related Commands

    Get-VBRHvProxy