---
title: "Set-VBRViLinuxProxy"
description: "This cmdlet modifies settings of Linux backup proxy servers. To modify settings, specify new values for the necessary parameters. The cmdlet will overwrite the previous parameter values with new values."
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/set-vbrvilinuxproxy.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Backup Infrastructure > Proxies > Set-VBRViLinuxProxy"
dateModified: "2026-08-19"
---

# Set-VBRViLinuxProxy

## Short Description
Modifies settings of Linux backup proxies.

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

## Syntax
```
Set-VBRViLinuxProxy -Proxy <CViProxy> [-Description <String>] [-ProxyVM <CViVmItem>]
 [-TransportMode <VBRProxyTransportMode>] [-ConnectedDatastoreMode <VBRProxyConnectedDatastoreMode>]
 [-Datastore <VBRViDatastore[]>] [-EnableFailoverToNBD] [-EnableHostToProxyEncryption] [-MaxTasks <Int32>]
 [-Force] [<CommonParameters>]
```

## Detailed Description
This cmdlet modifies settings of Linux backup proxy servers.

::: 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">ConnectedDatastoreMode</span></p>
        </td>
        <td>
          <p>Specifies the mode the Linux proxy will use to connect to datastores:</p><ul><li><code>Auto</code>: Veeam Backup & Replication automatically detects all datastores that allow direct SAN or NFS connection.</li><li><code>Manual</code>: Backup proxy has a direct SAN or NFS connection to datastores in the Datastore list. Use the <code>Datastore</code> parameter to specify the allowed datastores.</li></ul><p>Default: <code>Auto</code>.</p>
        </td>
        <td style="width:10%;">
          <p><code>VBRProxyConnectedDatastoreMode</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">Datastore</span></p>
        </td>
        <td>
          <p>Specifies an array of datastores to which the backup proxy has a direct SAN or NFS connection.</p><p>Accepts the <code>VBRViDatastore</code> [] object. To create this object, run the <a href="find-vbrvidatastore.md"><code>Find-VBRViDatastore</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>VBRViDatastore[]</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">Description</span></p>
        </td>
        <td>
          <p>Specifies a description of a Linux backup proxy.</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">EnableFailoverToNBD</span></p>
        </td>
        <td>
          <p>Enables failover to the Network transport mode if a backup proxy fails to transport data using the Direct storage access or Virtual appliance transport mode.</p><p>Default: <code>True</code>.</p><p><strong>Note</strong>: To disable this option, set the parameter value to <code>$false</code>. That is, <em>parameter_name</em><code>:$false</code>.</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">EnableHostToProxyEncryption</span></p>
        </td>
        <td>
          <p>Enables VM data transportation over an encrypted SSL connection in the Network transport mode.</p><p>Default: <code>False</code>.</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">Force</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will add a Linux backup proxy without showing warnings in the 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>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">MaxTasks</span></p>
        </td>
        <td>
          <p>Specifies the number of concurrent tasks that can be assigned to the backup proxy simultaneously.</p><p>Permitted values: <code>1</code>-<code>100</code>.</p><p>Default: <code>2</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">Proxy</span></p>
        </td>
        <td>
          <p>Specifies a Linux backup proxy. The cmdlet will modify the settings of this backup proxy.</p><p>Accepts the <code>CViProxy</code> object. To create this object, run the <a href="get-vbrviproxy.md"><code>Get-VBRViProxy</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>CViProxy</code></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">ProxyVM</span></p>
        </td>
        <td>
          <p>Specifies a Linux VM that is added to the VMware environment. The cmdlet will assign a backup proxy role explicitly to this Linux VM.</p><p>Accepts the <code>CViVmItem</code> object. To create this object, run the <a href="find-vbrvientity.md"><code>Find-VBRViEntity</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>CViVmItem</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">TransportMode</span></p>
        </td>
        <td>
          <p>Specifies a data transport mode that the Linux proxy will apply to retrieve VM data from the source and write VM data to the target. You can specify one of the following transport mode type:</p><p>Specifies the transport mode used by the backup proxy:</p><ul><li><code>Auto</code>: Use this option to set the automatic proxy selection mode.</li><li><code>DirectStorageAccess</code>: Use this option to set the direct storage access transport mode (Direct SAN access or Direct NFS access).</li><li><code>HotAdd</code>: Use this option to set the virtual appliance transport mode.</li><li><code>Nbd</code>: Use this option to set the network transport mode.</li></ul><p>Default: <code>Auto</code>.</p>
        </td>
        <td style="width:10%;">
          <p><code>VBRProxyTransportMode</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
The cmdlet returns the `VBRHvServerVolume` object that contains settings of Linux backup proxy added to the backup infrastructure.

## Examples

::: example
### Modifying Number of Concurrent Tasks

This example shows how to modify a number of concurrent tasks for the `Linux` server.

```
$proxy = Get-VBRViProxy -Name "LinProxy"
Set-VBRViLinuxProxy -Proxy $proxy -MaxTasks 4
```

Perform the following steps:

1. Run the [`Get-VBRViProxy`](get-vbrviproxy.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$proxy` variable.
2. Run the `Set-VBRViLinuxProxy` cmdlet. Set the `$proxy` variable as the `Proxy` parameter value. Specify the `MaxTasks` parameter value.

:::

## Related Commands

[`Get-VBRViProxy`](get-vbrviproxy.md)