---
title: "Set-VBRFiler"
description: "This cmdlet modifies settings of enterprise NAS systems added to the inventory. 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-vbrfiler.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Unstructured Data Backup > Working with Unstructured Data Source > Adding Enterprise Storage System as NAS Filer > Set-VBRFiler"
dateModified: "2026-08-20"
---

# Set-VBRFiler

## Short Description
Modifies enterprise NAS systems added as file shares to the inventory.

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

## Syntax

This cmdlet provides the following parameter sets:

<ul class="syntax-sets">
  <li>
    <p><code>AllParameterSets (Default)</code></p>

```
Set-VBRFiler -Filer <VBRFiler> [-CacheRepository <CBackupRepository>]
 [-MetaMigrationType <VBRNASBackupMetaMigrationType>] [-BackupIOControlLevel <VBRNASBackupIOControlLevel>]
 [-EnableSnapDiff] [-RequireAccessCredentials]
 [-RetrievalSettings <VBRUnstructuredBackupColdStorageRetrievalSettings>] [-Force] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>AddCredentials</code></p>

```
Set-VBRFiler -Filer <VBRFiler> [-CacheRepository <CBackupRepository>]
 [-MetaMigrationType <VBRNASBackupMetaMigrationType>] [-BackupIOControlLevel <VBRNASBackupIOControlLevel>]
 [-EnableSnapDiff] -User <String> -Password <String> [-RequireAccessCredentials]
 [-RetrievalSettings <VBRUnstructuredBackupColdStorageRetrievalSettings>] [-Force] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>Credentials</code></p>

```
Set-VBRFiler -Filer <VBRFiler> [-CacheRepository <CBackupRepository>]
 [-MetaMigrationType <VBRNASBackupMetaMigrationType>] [-BackupIOControlLevel <VBRNASBackupIOControlLevel>]
 [-EnableSnapDiff] -AccessCredentials <CCredentials> [-RequireAccessCredentials]
 [-RetrievalSettings <VBRUnstructuredBackupColdStorageRetrievalSettings>] [-Force] [<CommonParameters>]
```
  </li>
</ul>

## Detailed Description
This cmdlet modifies settings of enterprise NAS systems added to the inventory.

::: 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">AccessCredentials</span></p>
        </td>
        <td>
          <p>Specifies credentials that the cmdlet will use to authenticate against the enterprise NAS system.</p>
        </td>
        <td style="width:10%;">
          <p><code>CCredentials</code></p>
        </td>
        <td style="width:10%;">
          <p>True</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">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 .VCACHE files 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">EnableSnapDiff</span></p>
        </td>
        <td>
          <p>Use this parameter for Dell PowerScale (formerly Isilon) storages only.</p><p>Defines that during the file backup jobs Veeam Backup & Replication will use the file change tracking technology provided by the NAS manufacturer.</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">Filer</span></p>
        </td>
        <td>
          <p>Specifies the enterprise NAS system. The cmdlet will modify the settings of this server.</p><p>Accepts the <code>VBRFiler</code> object. To get this object, run the <a href="add-vbrfiler.md"><code>Add-VBRFiler</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>VBRFiler</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">Force</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will modify settings of enterprise NAS systems 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">Password</span></p>
        </td>
        <td>
          <p>Specifies the password. The cmdlet will use this password to authenticate against the enterprise NAS system.</p>
        </td>
        <td style="width:10%;">
          <p><code>String</code></p>
        </td>
        <td style="width:10%;">
          <p>True</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">RequireAccessCredentials</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will check whether Veeam Backup & Replication uses authentication to access the SMB network shared folder.</p><p>If you do not provide this parameter, the cmdlet will not check credentials that are used to access the SMB network shared folder.</p><p>To remove credentials, specify the <code>RequireAccessCredentials</code> parameter with the <code>:$False</code> value.</p><p><strong>Note</strong>: If credentials are not provided, the cmdlet will return an error. To avoid the error, you must specify credentials using either of the following parameters:</p><ul><li><code>User and Password</code></li><li><code>AccessCredentials</code></li></ul>
        </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">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">User</span></p>
        </td>
        <td>
          <p>Specifies the user name. The cmdlet will apply this user name to authenticate against the enterprise NAS system.</p>
        </td>
        <td style="width:10%;">
          <p><code>String</code></p>
        </td>
        <td style="width:10%;">
          <p>True</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 `VBRFiler` object that defines the settings of the enterprise NAS system added as a file share to the inventory.

## Examples

::: example
### Example 1. Modifying Enterprise NAS System Added as File Share Without Authentication

This example shows how to modify the enterprise NAS system as a file share to the inventory without authentication.

```
$filer = Get-VBRFiler -Name "ontap-2"
$repository = Get-VBRBackupRepository -Name "Backup Repository 02"
Set-VBRFiler -Filer $filer -CacheRepository $repository
```

Perform the following steps:

1. Run the [`Get-VBRFiler`](get-vbrfiler.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$filer` 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-VBRFiler` cmdlet. Specify the following settings:

   - Set the `$filer` variable as the `Filer` parameter value. 
   - Set the `$repository` variable as the `CacheRepository` parameter value.

:::

::: example
### Example 2. Modifying Enterprise NAS System Added as File Share with User Name and Password

This example shows how to modify the enterprise NAS system added as a file share to the inventory with user name and password.

```
$filer = Get-VBRFiler -Name "ontap-2"
$repository = Get-VBRBackupRepository -Name "Backup Repository 02"
Set-VBRFiler -Filer $filer -User Administrator -Password AdminCredentials -CacheRepository $repository
```

Perform the following steps:

1. Run the [`Get-VBRFiler`](get-vbrfiler.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$filer` 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-VBRFiler` cmdlet. Specify the following settings:

   - Set the `$filer` variable as the `Filer` parameter value.
   - Specify the `User` parameter value.
   - Specify the `Password` parameter value.
   - Set the `$repository` variable as the `CacheRepository` parameter value.

:::

::: example
### Example 3. Modifying Enterprise NAS System Added as File Share with Credentials

This example shows how to modify the enterprise NAS system added as a file share to the infrastructure with credentials.

```
$filer = Get-VBRFiler -Name "ontap-2"
$repository = Get-VBRBackupRepository -Name "Backup Repository 02"
$credentials = Get-VBRCredentials
Set-VBRFiler -Filer $filer -AccessCredentials $credentials -CacheRepository $repository
```

Perform the following steps:

1. Run the [`Get-VBRFiler`](get-vbrfiler.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$filer` 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 [`Get-VBRCredentials`](get-vbrcredentials.md) cmdlet. Save the result to the `$credentials` variable.
4. Run the `Set-VBRFiler` cmdlet. Specify the following settings:

   - Set the `$filer` variable as the `Filer` parameter value.
   - Set the `$credentials` variable as the `AccessCredentials` parameter value.
   - Set the `$repository` variable as the `CacheRepository` parameter value.

:::

## Related Commands

- [`Get-VBRFiler`](get-vbrfiler.md)
- [`Get-VBRBackupRepository`](get-vbrbackuprepository.md)
- [`Get-VBRCredentials`](get-vbrcredentials.md)