---
title: "Set-VBOInternetProxySettings"
description: "This cmdlet modifies global internet proxy server settings configured in Veeam Backup for Microsoft 365. To modify settings, you need to enter the necessary parameters with new values. The parameters that you omit will remain unchanged."
canonical: "https://helpcenter.veeam.com/docs/vbo365/powershell/set-vbointernetproxysettings.html"
breadcrumb: "PowerShell Reference > Veeam Backup for Microsoft 365 PowerShell Reference > Global Internet Proxy Server Settings > Set-VBOInternetProxySettings"
dateModified: "2026-08-21"
---

# Set-VBOInternetProxySettings

## Short Description
Modifies global internet proxy server settings.

## Syntax
```
Set-VBOInternetProxySettings [-UseInternetProxy] [-Hostname <String>] [-Port <UInt16>] [-UseAuthentication]
 [-Credential <PSCredential>] [<CommonParameters>]
```

## Detailed Description
This cmdlet modifies global internet proxy server settings configured in Veeam Backup for Microsoft 365.

To modify settings, you need to enter the necessary parameters with new values. The parameters that you omit will remain unchanged.

::: note

This cmdlet requires a `PSCredential` object. To obtain a `PSCredential` object, run the [`Get-Credential`](https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.security/get-credential) cmdlet.

:::

## 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">Credential</span></p>
        </td>
        <td>
          <p>Specifies credentials that you want to use for authenticating to the internet proxy server.</p>
        </td>
        <td style="width:10%;">
          <p><code>PSCredential</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">Hostname</span></p>
        </td>
        <td>
          <p>Specifies a DNS name or an IP address of an internet proxy server.</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">Port</span></p>
        </td>
        <td>
          <p>Specifies a port number. The cmdlet will use this port number to connect to the internet proxy server.</p><p>Default: <em>3128</em>.</p>
        </td>
        <td style="width:10%;">
          <p><code>UInt16</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">UseAuthentication</span></p>
        </td>
        <td>
          <p>Defines that the internet proxy server requires authentication.</p><p>Default: <em>False</em></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>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">UseInternetProxy</span></p>
        </td>
        <td>
          <p>Defines that Veeam Backup for Microsoft 365 will use an internet proxy server as a gateway.</p><p>Default: <em>False</em></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 the [About Common Parameters](http://go.microsoft.com/fwlink/p/?LinkID=113216) section of Microsoft Learn.

## Output Object
The cmdlet returns the [`VBOInternetProxySettings`](vbointernetproxysettings.md) object that contains internet proxy server settings.

## Examples

::: example
### Modifying Global Internet Proxy Server Settings

This command sets global internet proxy server settings.

```
Set-VBOInternetProxySettings -UseInternetProxy -Hostname internetProxy.local -Port 3128
```

:::