---
title: "Set-VBRSelectedPersonalFolders"
description: "This cmdlet modifies the scope of personal data for Veeam Agent Backup jobs that back up Microsoft Windows and Mac computers. To modify settings, specify new values for the necessary parameters."
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/set-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 > Set-VBRSelectedPersonalFolders"
dateModified: "2026-08-20"
---

# Set-VBRSelectedPersonalFolders

## Short Description
Modifies 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
```
Set-VBRSelectedPersonalFolders -SelectedPersonalFolders <VBRSelectedPersonalFolders> [-Desktop] [-Documents]
 [-Pictures] [-Video] [-Music] [-Favorites] [-Downloads] [-ApplicationData] [-Custom] [-Library]
 [-ExcludeRoamingUsers] [-ExcludeOneDrive] [<CommonParameters>]
```

## Detailed Description
This cmdlet modifies the scope of personal data for Veeam Agent Backup jobs that back up Microsoft Windows and Mac computers.

::: 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">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">SelectedPersonalFolders</span></p>
        </td>
        <td>
          <p>Specifies the scope of personal data that you want to modify.</p><p>Accepts the <a href="vbrselectedpersonalfolders.md"><code>VBRSelectedPersonalFolders</code></a> object. To create this object, run the <a href="new-vbrselectedpersonalfolders.md"><code>New-VBRSelectedPersonalFolders</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbrselectedpersonalfolders.md"><code>VBRSelectedPersonalFolders</code></a></p>
        </td>
        <td style="width:10%;">
          <p>True</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>True (ByValue)</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. Excluding Pictures Folder from Backup Scope

This example shows how to exclude data stored in the `Pictures` folder from the backup scope.

```
$job = Get-VBRComputerBackupJob -Name 'Backup policy'
$selectedFilesOptions = $job.SelectedFilesOptions
$selectedPersonalFolders = $selectedFilesOptions.SelectedPersonalFolders
$newSelectedPersonalFolders = Set-VBRSelectedPersonalFolders -SelectedPersonalFolders $selectedPersonalFolders -Pictures:$False
$newSelectedFilesOptions = Set-VBRSelectedFilesBackupOptions -Options $selectedFilesOptions -SelectedPersonalFolders $newSelectedPersonalFolders
Set-VBRComputerBackupJob -Job $job -SelectedFilesOptions $newSelectedFilesOptions
```

Perform the following steps:

1. Run the [`Get-VBRComputerBackupJob`](get-vbrcomputerbackupjob.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$job` variable.
2. Get the `SelectedFilesOptions` property of the `$job` variable. Save the result to the `$selectedFilesOptions` variable.
3. Get the `SelectedPersonalFolders` property of the `$selectedFilesOptions` variable. Save the result to the `$selectedPersonalFolders` variable.
4. Run the `Set-VBRSelectedPersonalFolders` cmdlet. Set the `$selectedPersonalFolders` variable as the `SelectedPersonalFolders` parameter value. Set the `False` option for the `Pictures` parameter value. Save the result to the `$newSelectedPersonalFolders` variable.
5. Run the [`Set-VBRSelectedFilesBackupOptions`](set-vbrselectedfilesbackupoptions.md) cmdlet. Set the `$selectedFilesOptions` variable as the `Options` parameter value. Set the `$newSelectedPersonalFolders` variable as the `SelectedPersonalFolders` parameter value. Save the result to the $`newSelectedFilesOptions` variable.
6. Run the [`Set-VBRComputerBackupJob`](set-vbrcomputerbackupjob.md) cmdlet. Set the `$job` variable as the `Job` parameter value. Set the `$newSelectedFilesOptions` variable as the `SelectedFilesOptions` parameter value.

:::

::: example
### Example 2. Modifying Scope of Personal Data for Backup Jobs that Back Up Microsoft Windows Computers

This example shows how to define the following settings for personal data scope:

- The cmdlet will include data stored in the *Favorites* and *Downloads* folders to the backup scope.
- The cmdlet will exclude data stored in the *OneDrive* folder from the backup scope.

```
$folders = New-VBRSelectedPersonalFolders
Set-VBRSelectedPersonalFolders -SelectedPersonalFolders $folders -Favorites -Downloads -ExcludeOneDrive
```

Perform the following steps:

1. Run the [`New-VBRSelectedPersonalFolders`](new-vbrselectedpersonalfolders.md) cmdlet. Save the result to the `$folders` variable.
2. Run the `Set-VBRSelectedPersonalFolders` cmdlet. Specify the following settings:

   - Set the `$folders` variable as the `SelectedPersonalFolders` parameter value. 
   - Provide the `Favorites` parameter.
   - Provide the `Downloads` parameter.
   - Provide the `ExcludeOneDrive` parameter.

:::

## Related Commands

[`New-VBRSelectedPersonalFolders`](new-vbrselectedpersonalfolders.md)