Add-VBRCloudGateway

In this article

    Short Description

    Creates cloud gateways for Veeam Cloud Connect.

    Applies to

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

    Requires a cloud provider license.

    Syntax

    Add-VBRCloudGateway [-Description <string>] [-Server <CHost>] [-IpAddress <ipaddress>] [-IncomingPort <int>] [-NATPort <int>] [-NetworkMode <VBRGatewayNetworkMode> {Direct | NAT}]  [<CommonParameters>]

    Detailed Description

    This cmdlet creates a cloud gateway.

    Parameters

    Parameter

    Description

    Required

    Position

    Accept
    Pipeline
    Input

    Accept
    Wildcard
    Characters

    Description

    Specifies the description of the cloud gateway.

    False

    Named

    False

    False

    Server

    Specifies server that will perform the role of a cloud gateway. You can select any server added to Veeam Backup & Replication on assign the cloud gateway role to the Veeam backup server itself.

    Accepts the server object type.

    Accepted server types: Windows, Local.

    Default: Local.

    False

    Named

    False

    False

    IpAddress

    Specifies an external IP address of the NAT or network interface gateway.

    Accepts IPAddress or the string type.

    False

    Named

    False

    False

    IncomingPort

    Specifies a port that will be used by the Veeam backup server to connect to the gateway.

    Permitted values: 1 to 65535.

    Default: 6180.

    False

    Named

    False

    False

    NATPort

    Specifies a port on the NAT gateway used for listening to connections from users and passing cloud commands from users to the SP Veeam backup server.

    Permitted values: 1 to 65535.

    Default: (for Direct) null, (for NAT) 8080.

    False

    Named

    False

    False

    NetworkMode

    Specifies the network mode: Direct, NAT.

    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

    VBRCloudGateway

    Example 1

    This command adds a new cloud gateway with a direct network connection.

    • The server that will be used as the cloud gateway is obtained with Get-VBRServer and assigned to the '$server' variable beforehand.
    • The external network gateway IP is 104.45.95.227.
    • The port that will be used by Veeam Backup & Replication to connect to the gateway server is '6260'.
    • The network mode is set to 'Direct'.

    Add-VBRCloudGateway -Server $server -Description "Gateway directly connected to Internet" -IpAddress 104.45.85.123 -IncomingPort 6260 -NetworkMode Direct

    Example 2

    This command adds a new cloud gateway in the local network behind the NAT gateway.

    • The server that will be used as the cloud gateway is obtained with Get-VBRServer and assigned to the '$server' variable beforehand.
    • The external NAT gateway IP is 104.45.95.227.
    • The port that will be used by Veeam Backup & Replication to connect to the gateway server is '6180'.
    • The port that will be used by the NAT gateway is '7180'.
    • The network mode is set to 'NAT'.

    Add-VBRCloudGateway -Server $server -Description "Gateway behind NAT" -IpAddress 104.45.95.227 -IncomingPort 6180 -NATPort 7180 -NetworkMode NAT

    Related Commands

    Get-VBRServer