---
title: "New-VBRFileToTapeObject"
description: "Defines settings of the source for the files to tape job. Product Edition: Standard, Enterprise, Enterprise Plus, Veeam Universal License This cmdlet creates the VBRFileToTapeObject object."
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/new-vbrfiletotapeobject.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Tape Devices > Tape Jobs > New-VBRFileToTapeObject"
dateModified: "2026-08-19"
---

# New-VBRFileToTapeObject

## Short Description
Defines settings of the source for the files to tape job.

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

## Syntax
```
New-VBRFileToTapeObject -NASServer <VBRUnstructuredServer> [-Path <String>] [-IncludeMask <String>]
 [-ExcludeMask <String>] [<CommonParameters>]
```

## Detailed Description
This cmdlet creates the [`VBRFileToTapeObject`](vbrfiletotapeobject.md) object. This object contains settings of files or directories that you want to add to a file to tape 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">ExcludeMask</span></p>
        </td>
        <td>
          <p>Specifies files that you want to exclude from the file to tape job.</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">IncludeMask</span></p>
        </td>
        <td>
          <p>Specifies files that you want to back up with the file to tape job.</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">NASServer</span></p>
        </td>
        <td>
          <p>Specifies network shared folders and file servers. Veeam Backup & Replication will back up these shared folders and file servers with the file to tape job.</p><p>Accepts the <code>VBRUnstructuredServer</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>VBRUnstructuredServer</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">Path</span></p>
        </td>
        <td>
          <p>Specifies the target file path.</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
[`VBRFileToTapeObject`](vbrfiletotapeobject.md)

## Examples

::: example
### Creating Object for File to Tape Job

This example shows how to create an object for a file to tape job. The object contains a folder on the `fileserver08` server.

```
$server = Get-VBRUnstructuredServer -Name "fileserver08.tech.local"
$folder = New-VBRFileToTapeObject -NASServer $server -Path "D:\Summary Reports\Payroll Reports"
```

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-VBRFileToTapeObject` cmdlet. Set the `$server` variable as the `NASServer` parameter value. Specify the `Path` parameter value. Save the result to the `$folder` variable to be used with other cmdlets.

:::

## Related Commands

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