---
title: "Set-VBRNASNFSServer"
description: "This cmdlet modifies settings of NFS network shared folders added to the inventory. This cmdlet modifies an existing VMware replication job. To modify settings, specify new values for the necessary parameters."
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/set-vbrnasnfsserver.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Unstructured Data Backup > Working with Unstructured Data Source > Adding File Shares > Set-VBRNASNFSServer"
dateModified: "2026-08-20"
---

# Set-VBRNASNFSServer

## Short Description
Modifies settings of NFS shared folders added to the inventory.

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

## Syntax
```
Set-VBRNASNFSServer -Server <VBRNASNFSServer> [-ProcessingMode <VBRNASProcessingMode>]
 [-ProxyMode <VBRNASProxyMode>] [-SelectedProxyServer <VBRNASProxyServer[]>]
 [-CacheRepository <CBackupRepository>] [-MetaMigrationType <VBRNASBackupMetaMigrationType>]
 [-RetrievalSettings <VBRUnstructuredBackupColdStorageRetrievalSettings>] [-StorageSnapshotPath <String>]
 [-BackupIOControlLevel <VBRNASBackupIOControlLevel>] [-EnableDirectBackupFailover]
 [-Encoding <VBRNASEncoding>] [-Force] [<CommonParameters>]
```

## Detailed Description
This cmdlet modifies settings of NFS network shared folders added to the inventory. This cmdlet modifies an existing VMware replication job.

::: 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">BackupIOControlLevel</span></p>
        </td>
        <td>
          <p>Specifies a speed that Veeam Backup & Replication will use to read data from the file server. You can specify either of the following speed:</p><ul><li><code>Lowest</code></li><li><code>Low</code></li><li><code>Medium</code></li><li><code>High</code></li><li><code>Highest</code></li></ul>
        </td>
        <td style="width:10%;">
          <p><code>VBRNASBackupIOControlLevel</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">CacheRepository</span></p>
        </td>
        <td>
          <p>Specifies the cache repository. Veeam Backup & Replication will keep the cached data of the NFS network shared folder on this repository.</p><p>Accepts the <code>CBackupRepository</code> object. To get this object, run the <a href="get-vbrbackuprepository.md"><code>Get-VBRBackupRepository</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>CBackupRepository</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">EnableDirectBackupFailover</span></p>
        </td>
        <td>
          <p>Enables the <code>StorageSnapshot</code> processing option.</p><p>Defines that if the native storage snapshot fails while being processed, Veeam Backup & Replication will backup data directly from the file server.</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">Encoding</span></p>
        </td>
        <td>
          <p>Specifies encoding for NFS share. You can specify either of the following values:</p><ul><li><code>utf</code></li><li><code>ansi</code></li></ul>
        </td>
        <td style="width:10%;">
          <p><code>VBRNASEncoding</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 modify settings of NFS shared folders 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">MetaMigrationType</span></p>
        </td>
        <td>
          <p>Specifies how the cmdlet will migrate metadata. You can use one of the following options:</p><ul><li><code>CheckExistence</code> — use this option to check that metadata is available on the current cache repository.</li><li><code>CopyMetaFromCache</code> — use this option to migrate metadata from source cache repository to a new cache repository. <strong>Note</strong>: If metadata in a source cache repository is corrupted, the cmdlet will copy data from the archive repository.</li><li><code>DownloadMetaFromArchive</code> — use this option to migrate metadata from archive repository or from replica metadata in archive repository.</li></ul>
        </td>
        <td style="width:10%;">
          <p><code>VBRNASBackupMetaMigrationType</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">ProcessingMode</span></p>
        </td>
        <td>
          <p>Specifies processing options that define how Veeam Backup & Replication will back up data.</p><ul><li><code>Direct:</code> use this option to back up directly from the SMB network shared folder. <strong>Note</strong>: This option does not back up locked files.</li><li><code>VSSSnapshot:</code> use this option to back up from VSS snapshots that have been created by the backup proxy.</li><li><code>StorageSnapshot:</code> use this option to back up from the native storage snapshots that have been created by the backup proxy.</li></ul>
        </td>
        <td style="width:10%;">
          <p><code>VBRNASProcessingMode</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">ProxyMode</span></p>
        </td>
        <td>
          <p>Specifies the backup proxy options.</p><ul><li><code>Automatic</code>: use this option if you want Veeam Backup & Replication to choose the backup proxy that will process the NFS network shared folder.</li><li><code>SelectedProxy:</code> use this option if you want to specify the backup proxy that will process the NFS network shared folder. Use the <code>SelectedProxyServer</code> parameter to specify the backup proxy.</li></ul>
        </td>
        <td style="width:10%;">
          <p><code>VBRNASProxyMode</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">RetrievalSettings</span></p>
        </td>
        <td>
          <p>Specifies the retrieval policy settings. The cmdlet will use these settings to retrieve data from archive repositories.</p><p>Accepts the <code>VBRUnstructuredBackupColdStorageRetrievalSettings</code> object. To create this object, run the <a href="new-vbrunstructuredbackupretrievalsettings.md"><code>New-VBRUnstructuredBackupColdStorageRetrievalSettings</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>VBRUnstructuredBackupColdStorageRetrievalSettings</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">SelectedProxyServer</span></p>
        </td>
        <td>
          <p>For the <code>SelectedProxy</code> option of the <code>ProxyMode</code> parameter.</p><p>Specifies the backup proxy. Veeam Backup & Replication will use this backup proxy to process the NFS network shared folder.</p><p>Accepts the <code>VBRNASProxyServer[]</code> object. To get this object, run the <a href="get-vbrnasproxyserver.md"><code>Get-VBRNASProxyServer</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbrnasproxyserver.md"><code>VBRNASProxyServer[]</code></a></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">Server</span></p>
        </td>
        <td>
          <p>Specify an NFS network shared folder. The cmdlet will modify settings of this network shared folder.</p><p>Accepts the <code>VBRNASNFSServer</code> object. To get this object, run the <a href="get-vbrunstructuredserver.md"><code>Get-VBRUnstructuredServer</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>VBRNASNFSServer</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">StorageSnapshotPath</span></p>
        </td>
        <td>
          <p>For the <code>StorageSnapshot</code> processing options.</p><p>Specifies the path to the folder where native storage snapshots are located. Veeam Backup & Replication will get data from these snapshots located at the specified folder.</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>
    </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 `VBRNASNFSServer` object that contains settings of the NFS network shared folder that is added to the inventory.

## Examples

::: example
### Example 1. Modifying Processing Options

This example shows how to modify the processing options of the `\\LinuxSRV2049\November` NFS network shared folder. Veeam Backup & Replication will create backups of the `\\LinuxSRV2049\November` NFS network shared folder from VSS snapshots that have been created by the backup proxy.

```
$server = Get-VBRUnstructuredServer -Name '\\LinuxSRV2049\November'
Set-VBRNASNFSServer -Server $server -ProcessingMode VSSSnapshot
```

Perform the following steps:

1. Run the [`Get-VBRUnstructuredServer`](get-vbrunstructuredserver.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$server` variable.
2. Run the `Set-VBRNASNFSServer` cmdlet. Set the `$server` variable as the `Server` parameter value. Set the `VSSSnapshot` option for the `ProcessingMode` parameter.

:::

::: example
### Example 2. Modifying Backup Proxy Options

This example shows how to modify the backup proxy options of the `\\LinuxSRV2049\November` NFS network shared folder. Veeam Backup & Replication will select the backup proxy to process the `\\LinuxSRV2049\November` NFS network shared folder automatically.

```
$server = Get-VBRUnstructuredServer -Name '\\LinuxSRV2049\November'
Set-VBRNASNFSServer -Server $server -ProxyMode Automatic
```

Perform the following steps:

1. Run the [`Get-VBRUnstructuredServer`](get-vbrunstructuredserver.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$server` variable.
2. Run the `Set-VBRNASSMBServer` cmdlet. Set the `$server` variable as the `Server` parameter value. Set the `Automatic` value as the `ProxyMode` parameter value.

:::

::: example
### Example 3. Modifying Cache Repository Settings

This example shows how to modify cache repository settings of the `\\LinuxSRV2049\November` NFS network shared folder. The `\\LinuxSRV2049\November` NFS network shared folder will be processed by the `Repository07` backup repository.

```
$server = Get-VBRUnstructuredServer -Name '\\LinuxSRV2049\November'
$repository = Get-VBRBackupRepository -Name 'Repository07'
Set-VBRNASSMBServer -Server $server -CacheRepository $repository
```

Perform the following steps:

1. Run the [`Get-VBRUnstructuredServer`](get-vbrunstructuredserver.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$server` variable.
2. Run the [`Get-VBRBackupRepository`](get-vbrbackuprepository.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$repository` variable.
3. Run the `Set-VBRNASSMBServer` cmdlet. Set the `$server` variable as the `Server` parameter value. Set the `$repository` variable as the `CacheRepository` parameter value.

:::

## Related Commands

- [`Get-VBRUnstructuredServer`](get-vbrunstructuredserver.md)
- [`Get-VBRBackupRepository`](get-vbrbackuprepository.md)