---
title: "New-VBRNASBackupJobObject"
description: "This cmdlet creates the VBRNASBackupJobObject object. This object contains settings of files and folders and enterprise NAS system that will be added to the file backup job."
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/new-vbrnasbackupjobobject.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Unstructured Data Backup > Working with Unstructured Data Source Jobs > Adding File Backup Jobs > New-VBRNASBackupJobObject"
dateModified: "2026-08-19"
---

# New-VBRNASBackupJobObject

## Short Description
Defines settings of files and folders and enterprise NAS system that will be added to the file backup job.

**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>

```
New-VBRNASBackupJobObject -Server <VBRNASServer> [-Path <String>] [-InclusionMask <VBRNASBackupMask[]>]
 [-ExclusionMask <VBRNASBackupMask[]>] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>SANEntity</code></p>

```
New-VBRNASBackupJobObject -SANEntity <VBRSANEntity> [-InclusionMask <VBRNASBackupMask[]>]
 [-ExclusionMask <VBRNASBackupMask[]>] [<CommonParameters>]
```
  </li>
</ul>

## Detailed Description
This cmdlet creates the `VBRNASBackupJobObject` object. This object contains settings of files and folders and enterprise NAS system that will be added to the file backup job.

## 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">ExclusionMask</span></p>
        </td>
        <td>
          <p>Specifies a file mask for folders and files that you do not want to add to the file backup job. The cmdlet will not back up these folders and files.</p>
        </td>
        <td style="width:10%;">
          <p><code>VBRNASBackupMask[]</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">InclusionMask</span></p>
        </td>
        <td>
          <p>Specifies a file mask for folders and files that you want to add to the file backup job. The cmdlet will back up only folders and files specified in this file mask.</p>
        </td>
        <td style="width:10%;">
          <p><code>VBRNASBackupMask[]</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">Path</span></p>
        </td>
        <td>
          <p>Specifies a path to folders and files.</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">SANEntity</span></p>
        </td>
        <td>
          <p>Specifies a name of an enterprise NAS system. The cmdlet will return an array of file shares residing on this NAS system.</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>True (ByPropertyName, ByValue)</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>Specifies the server with the file share.</p><p>Accepts the <code>VBRNASServer</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>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>True (ByPropertyName, ByValue)</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 `VBRNASBackupJobObject` object that contains settings of files and folders that will be added to the file backup job.

## Examples

::: example
### Example 1. Defining Folders to Add to File Backup Job

This example shows how to define folders that you want to add to the file backup job. The job will back up all files that are located in the `\\WinSRV2049\Documents\January` folder.

```
$server = Get-VBRUnstructuredServer -Name "\\WinSRV2049\Documents"
New-VBRNASBackupJobObject -Server $server -Path "//WinSRV2049/Documents/January"
```

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 `New-VBRNASBackupJobObject` cmdlet. Set the `$server` variable as the `Server` parameter value. Specify the `Path` parameter value.

:::

::: example
### Example 2. Defining Included Files to Add to File Backup Job

This example shows how to define a mask for files that you want to add to the file backup job. The job will back up only .`DOCX` files that are located in the `\\WinSRV2049\Documents\January` folder.

```
$server = Get-VBRUnstructuredServer -Name "\\WinSRV2049\Documents"
New-VBRNASBackupJobObject -Server $server -Path "//WinSRV2049/Documents/January" -InclusionMask "*.docx"
```

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 `New-VBRNASBackupJobObject` cmdlet. Specify the following settings:

   - Set the `$server` variable as the `Server` parameter value.
   - Specify the `Path` parameter value.
   - Specify the `InclusionMask` parameter value.

:::

::: example
### Example 3. Defining Excluded Files to Add to File Backup Job

This example shows how to define a mask for files that you want to exclude from the file backup job. The job will not back up .`EXE` files that are located in the `\\WinSRV2049\Documents\January` folder.

```
$server = Get-VBRUnstructuredServer -Name "\\WinSRV2049\Documents"
New-VBRNASBackupJobObject -Server $server -Path "//WinSRV2049/Documents/January" -ExclusionMask "*.exe"
```

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 `New-VBRNASBackupJobObject` cmdlet. Specify the following settings:

   - Set the `$server` variable as the `Server` parameter value.
   - Specify the `Path` parameter value.
   - Specify the `ExclusionMask` parameter value.

:::

## Related Commands

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