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

Add-VBRHvProxy

In this article

    Short Description

    Adds a Hyper-V backup proxy to Veeam Backup & Replication.

    Applies to

    Platform: Hyper-V

    For VMware, run Add-VBRViProxy.

    Product Edition: Standard, Enterprise, Enterprise Plus

    Syntax

    Add-VBRHvProxy -Server <CHost> [-Description <String>] [-MaxTasks <Int32>] [-WarningAction <ActionPreference>] [-WarningVariable <String>] [<CommonParameters>]

    Related Commands

    Get-VBRServer

    Detailed Description

    This cmdlet adds a Hyper-V backup proxy server to the Veeam Backup & Replication managing console.

    When you add a proxy, you set a role to a Microsoft Windows server. To add a new proxy, you need to have the server added to your Veeam Backup & Replication managing console.

    Run Add-VBRWinServer to add a Microsoft Windows server.

    Parameters

    Parameter

    Description

    Required

    Position

    Accept
    Pipeline
    Input

    Accept
    Wildcard
    Characters

    Server

    Specifies the server which will act as a Hyper-V backup proxy.

    True

    Named

    True (ByValue,
    ByProperty
    Name)

    False

    Description

    Specifies the description of the Hyper-V proxy.

    If not set, Veeam Backup & Replication will enter date and time of creation by default.

    False

    Named

    False

    False

    MaxTasks

    Sets the integer specifying the number of concurrent tasks that can be assigned to the proxy simultaneously.

    If not set, the number of tasks will be set to 2 by default.

    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 adds a new proxy. The server that will act as the proxy is obtained with Get-VBRServer and piped down. The description is "Local Backup Proxy". The max concurrent tasks number is set to 6.

    Get-VBRServer -Name "HyperV Local Server" | Add-VBRHvProxy -Description "Local Backup Proxy" -MaxTasks 6

    Example 2

    This command adds a new proxy. The server that will act as the proxy is obtained with Get-VBRServer and assigned to the $server variable. The description is "Local Backup Proxy". The max concurrent tasks number is not set to enable the default value.

    Add-VBRHvProxy -Server $server -Description "Local Backup Proxy"