---
title: "Set-VBRDefaultGateway"
description: "This cmdlet modifies the default 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-vbrdefaultgateway.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Veeam Cloud Connect > Veeam Cloud Connect Failover Plans > Set-VBRDefaultGateway"
dateModified: "2026-08-19"
---

# Set-VBRDefaultGateway

## Short Description
Modifies cloud default gateways.

**Platform**: VMware, Hyper-V

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

## Syntax
```
Set-VBRDefaultGateway -Gateway <VBRDefaultGateway> [-IpAddress <String>] [-NetworkMask <String>]
 [-Ipv6Address <String>] [-Ipv6SubnetAddress <String>] [-Ipv6PrefixLength <Byte>] [-PassThru] [<CommonParameters>]
```

## Detailed Description
This cmdlet modifies the default 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">Gateway</span></p>
        </td>
        <td>
          <p>Specifies the default cloud gateway you want to modify.</p><p>Accepts the <a href="vbrdefaultgateway.md"><code>VBRDefaultGateway</code></a> object. To get this object, run the <a href="get-vbrdefaultgatewayconfiguration.md"><code>Get-VBRDefaultGatewayConfiguration</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbrdefaultgateway.md"><code>VBRDefaultGateway</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">IpAddress</span></p>
        </td>
        <td>
          <p>Specifies the IP address you want to assign to the default 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">Ipv6Address</span></p>
        </td>
        <td>
          <p>Specifies the IPv6 address that you want to assign to the default 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">Ipv6PrefixLength</span></p>
        </td>
        <td>
          <p>Specifies the length of an IPv6 prefix.</p>
        </td>
        <td style="width:10%;">
          <p><code>Byte</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">Ipv6SubnetAddress</span></p>
        </td>
        <td>
          <p>Specifies the production IPv6 network.</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">NetworkMask</span></p>
        </td>
        <td>
          <p>Specifies the network mask you want to assign to the default 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">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
[`VBRDefaultGateway`](vbrdefaultgateway.md)

## Examples

::: example
### Setting IP Address and Network Mask for Selected Default Gateway

This example shows how to set the IP address and the network mask for the selected default gateway.

```
$config = Get-VBRDefaultGatewayConfiguration
$alldefaultgateways = $config.Defaultgateway.name
$alldefaultgateways
$defaultgateway = $c.Defaultgateway[0]
Set-VBRDefaultGateway -Gateway $defaultgateway -IpAddress "172.16.2.232" -NetworkMask "255.255.0.0"
```

Perform the following steps:

1. Run the [`Get-VBRDefaultGatewayConfiguration`](get-vbrdefaultgatewayconfiguration.md) cmdlet. Save the result to the `$config` variable.
2. Get all default gateways by name. Save the array of gateways to the `$alldefaultgateways` variable.
3. Run the `$alldefaultgateways` variable to see all the names of all gateways available.
4. Select the first default gateway from the array. Save the result to the `$config.Defaultgateway.name` variable.
5. Run the `Set-VBRDefaultGateway` cmdlet. Set the `$defaultgateway` variable as the `Gateway` parameter value. Specify the `IPAddress` and the `NetworkMask` parameter values.

:::

## Related Commands

[`Set-VBRDefaultGatewayConfiguration`](set-vbrdefaultgatewayconfiguration.md)