---
title: "Set-VBRCloudGateway"
description: "This cmdlet modifies an existing cloud gateway. To modify settings, specify new values for the necessary parameters. The cmdlet will overwrite the previous parameter values with new values. The parameters that you omit will remain unchanged."
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/set-vbrcloudgateway.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Veeam Cloud Connect > Veeam Cloud Connect Cloud Gateways > Set-VBRCloudGateway"
dateModified: "2026-08-19"
---

# Set-VBRCloudGateway

## Short Description
Modifies cloud gateways.

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

Requires a cloud provider license.

## Syntax
```
Set-VBRCloudGateway -CloudGateway <VBRCloudGateway> [-Description <String>] [-IpAddress <String>]
 [-IncomingPort <Int32>] [-NATPort <Int32>] [-PassThru] [-NetworkMode <VBRGatewayNetworkMode>] [<CommonParameters>]
```

## Detailed Description
This cmdlet modifies an existing cloud gateway.

::: note

To modify settings, specify new values for the necessary parameters. The cmdlet will overwrite the previous parameter values with new values. The parameters that you omit will remain unchanged.

:::

## Parameters

<table style="width:100%;" class="Blue_Table">
      <tr style="vertical-align:top">
        <th style="width:20%;">
          <p>Parameter</p>
        </th>
        <th style="width:20%;">
          <p>Description</p>
        </th>
        <th style="width:20%;">
          <p>Type</p>
        </th>
        <th style="width:10%;">
          <p>Required</p>
        </th>
        <th style="width:10%;">
          <p>Position</p>
        </th>
        <th style="width:10%;">
          <p>Accept Pipeline Input</p>
        </th>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">CloudGateway</span></p>
        </td>
        <td>
          <p>Specifies the cloud gateway you want to modify.</p><p>Accepts the <a href="vbrcloudgateway.md"><code>VBRCloudGateway</code></a> object. To get this object, run the <a href="get-vbrcloudgateway.md"><code>Get-VBRCloudGateway</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbrcloudgateway.md"><code>VBRCloudGateway</code></a></p>
        </td>
        <td style="width:10%;">
          <p>True</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>True (ByPropertyName, ByValue)</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Description</span></p>
        </td>
        <td>
          <p>Specifies the description of the cloud gateway.</p>
        </td>
        <td style="width:10%;">
          <p><code>String</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">IncomingPort</span></p>
        </td>
        <td>
          <p>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.</p><p>Permitted values: <code>1</code> to <code>65535</code>.</p><p>Default: <code>6180</code>.</p>
        </td>
        <td style="width:10%;">
          <p><code>Int32</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">IpAddress</span></p>
        </td>
        <td>
          <p>Specifies an external IP address of the NAT or network interface gateway.</p><p>Accepts <code>IPAddress</code> or string.</p>
        </td>
        <td style="width:10%;">
          <p><code>String</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">NATPort</span></p>
        </td>
        <td>
          <p>Specifies an external port that will be used by the Veeam backup server to connect to the gateway.</p><p>Permitted values: <code>1</code> to <code>65535</code>.</p><p>Default: (for Direct) <code>null</code>, (for NAT) <code>6180</code>.</p>
        </td>
        <td style="width:10%;">
          <p><code>Int32</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">NetworkMode</span></p>
        </td>
        <td>
          <p>Specifies network mode: <code>Direct</code>, <code>NAT</code>.</p>
        </td>
        <td style="width:10%;">
          <p><code>VBRGatewayNetworkMode</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">PassThru</span></p>
        </td>
        <td>
          <p>Defines that the command returns the output object to the Windows PowerShell console.</p>
        </td>
        <td style="width:10%;">
          <p><code>SwitchParameter</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
    </table>

`<CommonParameters>`

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see [ Microsoft Docs](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_commonparameters?view=powershell-7).

## Output Object
[`VBRCloudGateway`](vbrcloudgateway.md)

## Examples

::: example
### Example 1. Setting New Port for Cloud Gateway [Using Variable]

This example shows how to set a new port for the cloud gateway to connect to Veeam Backup & Replication. The new port number is set to `9012`.

```
$cloudgateway = Get-VBRCloudGateway -Name "Cloud Gateway"
Set-VBRCloudGateway -CloudGateway $cloudgateway -IncomingPort 9012
```

Perform the following steps:

1. Run the [`Get-VBRCloudGateway`](get-vbrcloudgateway.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$cloudgateway` variable.
2. Run the `Set-VBRCloudGateway` cmdlet. Set the `$cloudgateway` variable as the `CloudGateway` parameter value. Specify the `IncomingPort` parameter value.

:::

::: example
### Example 2. Setting New Port for Cloud Gateway [Using Pipeline]

This example shows how to set a new cloud gateway IP address and port to connect to Veeam Backup & Replication. The IP address is set to `172.16.10.20` and the port is set to `8062`.

```
Get-VBRCloudGateway | Set-VBRCloudGateway -IpAddress 172.16.10.20 -IncomingPort 8062
```

Perform the following steps:

1. Run the [`Get-VBRCloudGateway`](get-vbrcloudgateway.md) cmdlet.
2. Pipe the cmdlet output to the `Set-VBRCloudGateway` cmdlet. Specify the `IpAddress` and the `IncomingPort` parameter values.

:::

## Related Commands

[`Get-VBRCloudGateway`](get-vbrcloudgateway.md)