Add-VBOExcludedBackupItem - Veeam Backup for Microsoft 365 PowerShell Reference

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

Parameter	Description	Type	Required	Position	Accept Pipeline Input
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.	True	Named	False
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.	True	Named	False

Parameter

Description

Type

Required

Position

Accept Pipeline Input

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.

True

Named

False

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.

True

Named

False

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.

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.