Add-VBOExcludedBackupItem

Short Description

Creates a list of objects excluded from a backup job.

Syntax

Add-VBOExcludedBackupItem -Job <VBOJob> -BackupItem <VBOBackupItem[]> [<CommonParameters>]

Detailed Description

This cmdlet creates a list of objects that will be excluded from a backup job.

Run the Get-VBOExcludedBackupitem cmdlet to get a list of excluded items.

Parameters

Parameters
Parameter	Description	Type	Required	Position	Accept Pipeline Input
BackupItem	Specifies an array of objects that you want to exclude from the backup job. Note: Team objects can be excluded from the backup job only if the chats option is enabled for this team. Accepts the `VBOBackupItem[]` object. To get this object, run the `Get-VBOBackupItem` cmdlet.	`VBOBackupItem[]`	True	Named	False
Job	Specifies a backup job. The cmdlet will exclude objects from this backup job. Accepts the `VBOJob` object. To get this object, run the `Get-VBOJob` cmdlet.	`VBOJob`	True	Named	False

<CommonParameters>

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see the About Common Parameters section of Microsoft Learn.

Examples

Add-VBOExcludedBackupItem Example 1: Excluding Site Objects

This example shows how to exclude objects of a SharePoint organization site from the Yearly Backup backup job.

$yearlyjob = Get-VBOJob -Name "Yearly Backup"

$organization = Get-VBOOrganization -Name "ABC"

$site = "https://exampleorganization.sharepoint.com/sites/excludedsite"

$excludedsite = Get-VBOOrganizationSite -Organization $organization -URL $site

$excludeditems = New-VBOBackupItem -Site $excludedsite

Add-VBOExcludedBackupItem -Job $yearlyjob -BackupItem $excludeditems

Perform the following steps:

Run the Get-VBOJob cmdlet to specify a job to which you want to add a list of excluded items. Set Yearly Backup as the Name parameter value. Save the result to the $yearlyjob variable.
Run the Get-VBOOrganization cmdlet with the Name parameter to get the organization with the name ABC. Save the result to the $organization variable.
Save URL address of a SharePoint organization site that you want to exclude to the $site variable.
Run the Get-VBOOrganizationSite cmdlet with the $organization variable and the $site variable as the URL parameter value. Save the result to the $excludedsite variable.
Run the New-VBOBackupItem cmdlet with the $excludedsite variable to create item that represents a SharePoint organization site with a given URL. Save the result to the $excludeditems variable.
Run the Add-VBOExcludedBackupItem cmdlet. Set the $yearlyjob variable as the Job parameter value. Set the $excludeditems variable as the BackupItem parameter value.

Add-VBOExcludedBackupItem Example 2: Excluding Objects Specified as Backup Items for Another Backup Job

This example shows how to get backup items from the Yearly Backup backup job and to add them as excluded items to the Monthly Backup backup job.

$yearlyjob = Get-VBOJob -Name "Yearly Backup"

$item = Get-VBOBackupItem -Job $yearlyjob

$monthlyjob = Get-VBOJob -Name "Monthly Backup"

Add-VBOExcludedBackupItem -Job $monthlyjob -BackupItem $item

Perform the following steps:

Run the Get-VBOJob cmdlet to specify a job from which you want to get items. Set Yearly Backup as the Name parameter value. Save the result to the $yearlyjob variable.
Run the Get-VBOBackupItem cmdlet. Set the $yearlyjob variable as the Job parameter value. Save the result to the $item variable.
Run the Get-VBOJob cmdlet to specify a job to which you want to add a list of excluded items. Set Monthly Backup as the Name parameter value. Save the result to the $monthlyjob variable.
Run the Add-VBOExcludedBackupItem cmdlet. Set the $monthlyjob variable as the Job parameter value. Set the $item variable as the BackupItem parameter value.