---
title: "Update-VBRNasBackupPath (obsolete)"
description: "This cmdlet updates the file path to the source file share. To correctly update the source file share path for a file backup job that has a configured secondary target, refer to the Updating Source File Share Path for Backup Jobs with Secondary..."
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/update-vbrnasbackuppath.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Obsolete Cmdlets > Update-VBRNasBackupPath (obsolete)"
dateModified: "2026-08-19"
---

# Update-VBRNasBackupPath

## Short Description
Updates the file path to the source file share.

::: note

This cmdlet is obsolete. Run the [`Update-VBRUnstructuredBackupPath`](update-vbrunstructuredbackuppath.md) cmdlet instead.

:::

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

## Syntax

This cmdlet provides the following parameter sets:

<ul class="syntax-sets">
  <li>
    <p><code>NASServer</code></p>

```
Update-VBRNasBackupPath -Backup <VBRNASBackup> -SourceNASServer <VBRNASServer> -TargetNASServer <VBRNASServer>
 [-WhatIf] [-Confirm] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>RootNASServerByName</code></p>

```
Update-VBRNasBackupPath -Backup <VBRNASBackup> -SourceRootNASServerName <String>
 -TargetRootNASServer <VBRNASServer> [-WhatIf] [-Confirm] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>SANEntity</code></p>

```
Update-VBRNasBackupPath -Backup <VBRNASBackup> -SourceSANEntity <VBRSANEntity> -TargetSANEntity <VBRSANEntity>
 [-WhatIf] [-Confirm] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>SanHostByName</code></p>

```
Update-VBRNasBackupPath -Backup <VBRNASBackup> -SourceSANHostName <String> -TargetSANHost <VBRSANEntity>
 [-WhatIf] [-Confirm] [<CommonParameters>]
```
  </li>
</ul>

## Detailed Description
This cmdlet updates the file path to the source file share.

::: important

To correctly update the source file share path for a file backup job that has a configured secondary target, refer to the [Updating Source File Share Path for Backup Jobs with Secondary Target](https://helpcenter.veeam.com/docs/backup/vsphere/update_source_share_path.html?ver=120) section in the Veeam Backup & Replication User Guide.

:::

## 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">Backup</span></p>
        </td>
        <td>
          <p>Specifies a file share backup. The cmdlet will update the path to the source file share for this backup.</p><p>Accepts the <code>VBRNASBackup</code> object. To get this object, run the <a href="get-vbrnasbackup.md"><code>Get-VBRNASBackup</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>VBRNASBackup</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">SourceNASServer</span></p>
        </td>
        <td>
          <p>Specifies the file share server. The cmdlet will update this path/file share/server name to a new one.</p><p>Accepts the <code>VBRNASServer</code> object. To get this object, run the <a href="get-vbrnasserver.md"><code>Get-VBRNASServer</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>VBRNASServer</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">SourceRootNASServerName</span></p>
        </td>
        <td>
          <p>Specifies a new name of of the root server. The cmdlet will add this name to a configuration database.</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">SourceSANEntity</span></p>
        </td>
        <td>
          <p>Specifies the enterprise NAS system or its volume where the file shares reside. The cmdlet will update the path to this NAS system to a new path.</p><p>Accepts the <code>VBRSANEntity</code> object. To create this object, run the <a href="get-netapphost.md"><code>Get-NetAppHost</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>VBRSANEntity</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">SourceSANHostName</span></p>
        </td>
        <td>
          <p>Specifies the name of the SAN host object to be changed in the backup.</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">TargetNASServer</span></p>
        </td>
        <td>
          <p>Specifies the file share server. The cmdlet will update the file share path/name/server name to this one.</p><p>Accepts the <code>VBRNASServer</code> object. To get this object, run the <a href="get-vbrnasserver.md"><code>Get-VBRNASServer</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>VBRNASServer</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">TargetRootNASServer</span></p>
        </td>
        <td>
          <p>Specifies the file share server. The cmdlet will update the root server name to this one.</p><p>Accepts the <code>VBRNASServer</code> object. To get this object, run the <a href="get-vbrnasserver.md"><code>Get-VBRNASServer</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>VBRNASServer</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">TargetSANEntity</span></p>
        </td>
        <td>
          <p>Specifies the enterprise NAS system or its volume where the file share will reside. The cmdlet will use this NAS system entity as a new one when updating the backup information.</p><p>Accepts the <code>VBRSANEntity</code> object. To create this object, run the <a href="get-netapphost.md"><code>Get-NetAppHost</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>VBRSANEntity</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">TargetSANHost</span></p>
        </td>
        <td>
          <p>Specifies the enterprise NAS system or its volume where the file share will reside. The cmdlet will use this NAS system entity as a new one when updating the backup information.</p><p>Accepts the <code>VBRSANEntity</code> object. To create this object, run the <a href="get-netapphost.md"><code>Get-NetAppHost</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>VBRSANEntity</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">Confirm</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will display a prompt that asks if you want to continue running the command.</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">WhatIf</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will write a message that describes the effects of running the cmdlet without actually performing any action.</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
The cmdlet returns the `VBRNASBackup` object that defines results of updating the paths to the protected file share.

## Examples

::: example
### Example 1. Updating Path to Existing Source File Share Protected by a File Backup Job

This example shows how to update the path to the existing source SMB or NFS file share or root server protected by a file backup job.

```
$nasbackup = Get-VBRNASBackup -Name "File Backup Job 1"
$sourceserver = Get-VBRNASServer -Backup $nasbackup
$targetserver = Get-VBRNASServer -Name "\\WinSRV2049\Documents"
Update-VBRNasBackupPath -Backup $nasbackup -SourceNASServer $sourceserver -TargetNASServer $targetserver
```

Perform the following steps:

1. Run the [`Get-VBRNASBackup`](get-vbrnasbackup.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$nasbackup` variable.
2. Run the [`Get-VBRNASServer`](get-vbrnasserver.md) cmdlet. Set the `$nasbackup` variable as the `Backup` parameter value. Save the result to the `$sourceserver` variable.
3. Run the [`Get-VBRNASServer`](get-vbrnasserver.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$targetserver` variable.
4. Run the `Update-VBRNasBackupPath` cmdlet. Specify the following settings:

   - Set the `$nasbackup` variable as the `Backup` parameter value.
   - Set the `$sourceserver` variable as the `SourceNASServer` parameter value.
   - Set the `$targetserver` variable as the `TargetNASServer` parameter value.

:::

::: example
### Example 2. Updating Name of Root File Share Server

This example shows how to update the name of the root server to the name that does not exist in the Veeam Backup & Replication database.

```
$nasbackup = Get-VBRNASBackup -Name "File Backup Job 1"
$targetserver = Get-VBRNASServer -Name "\\WinSRV2049\Reports"
Update-VBRNasBackupPath -Backup $nasbackup -SourceRootNASServerName "\\WinSRV2049\Root" -TargetRootNASServer $targetserver
```

Perform the following steps:

1. Run the [`Get-VBRNASBackup`](get-vbrnasbackup.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$nasbackup` variable.
2. Run the [`Get-VBRNASServer`](get-vbrnasserver.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$targetserver` variable.
3. Run the `Update-VBRNasBackupPath` cmdlet. Specify the following settings:

   - Set the `$nasbackup` variable as the `Backup` parameter value.
   - Specify the `SourceRootNASServerName` parameter value.
   - Set the `$targetserver` variable as the `TargetNASServer` parameter value.

:::

::: example
### Example 3. Updating SAN Host

This example shows how to update the SAN host.

```
$nasbackup = Get-VBRNASBackup -Name "File Backup Job 1"
$sourcenetapp = Get-NetAppHost -Name "pdc-ontap-1"
$targetnetapp = Get-NetAppHost -Name "pdc-ontap-3"
Update-VBRNasBackupPath -Backup $nasbackup -SourceSANEntity $sourcenetapp -TargetSANEntity $targetnetapp
```

Perform the following steps:

1. Run the [`Get-VBRNASBackup`](get-vbrnasbackup.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$nasbackup` variable.
2. Run the [`Get-NetAppHost`](get-netapphost.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$sourcenetapp` variable.
3. Run the [`Get-NetAppHost`](get-netapphost.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$targetnetapp` variable.
4. Run the `Update-VBRNasBackupPath` cmdlet. Specify the following settings:

   - Set the `$nasbackup` variable as the `Backup` parameter value.
   - Set the `$sourcenetapp` variable as the `SourceSANEntity` parameter value.
   - Set the `$targetnetapp` variable as the `TargetSANEntity` parameter value.

:::

::: example
### Example 4. Updating SAN Host Name

This example shows how to update the name of the SAN host. The cmdlet will change the SAN hpst name from `pdc-ontap-3` to `pdc-ontap-5`.

```
$nasbackup = Get-VBRNASBackup -Name "File Backup Job 1"
$targetnetapp = Get-NetAppHost -Name "pdc-ontap-3"
Update-VBRNasBackupPath -Backup $nasbackup -SourceSANHostName "pdc-ontap-5" -TargetSANHost $targetnetapp
```

Perform the following steps:

1. Run the [`Get-VBRNASBackup`](get-vbrnasbackup.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$nasbackup` variable.
2. Run the [`Get-NetAppHost`](get-netapphost.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$targetnetapp` variable.
3. Run the `Update-VBRNasBackupPath` cmdlet. Specify the following settings:

   - Set the `$nasbackup` variable as the `Backup` parameter value.
   - Specify the `SourceSANHostName` parameter value.
   - Set the `$targetnetapp` variable as the `TargetSANHost` parameter value.

:::

## Related Commands

- [`Get-VBRNASBackup`](get-vbrnasbackup.md)
- [`Get-VBRNASServer`](get-vbrnasserver.md)