---
title: "New-VBRSelectedPersonalFolders"
description: "Defines the scope of personal data for Agent Backup jobs that back up Microsoft Windows and Mac computers. Product Edition: Standard, Enterprise, Enterprise Plus, Veeam Universal License This cmdlet creates the VBRSelectedPersonalFolders object that "
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/new-vbrselectedpersonalfolders.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Veeam Agent Management > Working with Veeam Agent Backup Jobs and Policies > Veeam Agent Job Backup Scope > New-VBRSelectedPersonalFolders"
dateModified: "2026-08-19"
---

# New-VBRSelectedPersonalFolders

## Short Description
Defines the scope of personal data for Agent Backup jobs that back up Microsoft Windows and Mac computers.

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

## Syntax
```
New-VBRSelectedPersonalFolders [-Desktop] [-Documents] [-Pictures] [-Video] [-Music] [-Favorites] [-Downloads]
 [-ApplicationData] [-Custom] [-Library] [-ExcludeRoamingUsers] [-ExcludeOneDrive] [<CommonParameters>]
```

## Detailed Description
This cmdlet creates the [`VBRSelectedPersonalFolders`](vbrselectedpersonalfolders.md) object that specifies the scope of personal data for Agent Backup jobs that back up Microsoft Windows and Mac computers.

## 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">ApplicationData</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will include to the backup scope application data stored on the system volume.</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">Custom</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will include to the backup scope data stored in the in custom locations on the system volume.</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">Desktop</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will include to the backup scope data stored in the <em>Desktop</em> folder on the system volume.</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">Documents</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will include to the backup scope data stored in the <em>Documents</em> folder on the system volume.</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">Downloads</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will include to the backup scope data stored in the <em>Downloads</em> folder on the system volume.</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">ExcludeOneDrive</span></p>
        </td>
        <td>
          <p>Excludes data stored in the <em>OneDrive</em> folder from the backup scope on Microsoft Windows computers. If you do not provide this parameter, the cmdlet will include data stored in the <em>OneDrive</em> folder to the backup scope.</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">ExcludeRoamingUsers</span></p>
        </td>
        <td>
          <p>Excludes roaming user profiles from the backup scope on Microsoft Windows computers. If you do not provide this parameter, the cmdlet will include roaming user profiles to the backup scope.</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">Favorites</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will include to the backup scope data stored in the <em>Favorites</em> folder on the system volume of Microsoft Windows computers.</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">Library</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will include to the backup scope data stored in the <em>Library</em> folder on the system volume of Mac computers.</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">Music</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will include to the backup scope data stored in the <em>Music</em> folder on the system volume.</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">Pictures</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will include to the backup scope data stored in the <em>Pictures</em> folder on the system volume.</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">Video</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will include to the backup scope data stored in the following folders on the system volume:</p><ul><li><em>Video</em> — for Microsoft Windows computers.</li><li><em>Movies</em> — for Mac computers.</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>
    </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
[`VBRSelectedPersonalFolders`](vbrselectedpersonalfolders.md)

## Examples

::: example
### Example 1. Including Desktop Folder in Backup Scope

This command includes to the backup scope data stored in the *Desktop* folder on the system volume. Save the result to the `$folders` variable.

```
$folders = New-VBRSelectedPersonalFolders -Desktop
```

:::

::: example
### Example 2. Including Pictures Folder in Backup Scope

This command includes to the backup scope data stored in the *Pictures* folder on the system volume. Save the result to the `$folders` variable.

```
$folders = New-VBRSelectedPersonalFolders -Pictures
```

:::

::: example
### Example 3. Excluding Roaming User Profiles from Backup Scope

This command excludes roaming user profiles from the backup scope. Save the result to the `$folders` variable.

```
$folders = New-VBRSelectedPersonalFolders -ExcludeRoamingUsers
```

:::