Add-VBOBackupItem

Short Description

Adds a list of objects to a backup job.

Syntax

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

Detailed Description

This cmdlet adds a list of objects to a backup job. The job will process these objects.

Add-VBOBackupItem Note

Before you add an object to a backup job, consider the following restrictions:

Only one job can back up an entire organization.
Several jobs cannot back up the same object.
If you add an object that has already been added to the backup job again, a new object will replace the old object.

Parameters

Parameter	Description	Type	Required	Position	Accept Pipeline Input	Accept Wildcard Characters
Job	Specifies a backup job. The cmdlet will add an array of objects to this job.	Accepts the VBOJob object. To get this object, run the Get-VBOJob cmdlet.	True	Named	False	False
BackupItem	Specifies an array of objects. The cmdlet will add them to a list of included objects.	Accepts the VBOBackupItem[] object. To get this object, run the Get-VBOBackupItem cmdlet. To create this object, run the New-VBOBackupItem cmdlet.	True	Named	false	False

Parameter

Description

Type

Required

Position

Accept Pipeline Input

Accept Wildcard Characters

Job

Specifies a backup job. The cmdlet will add an array of objects to this job.

Accepts the VBOJob object.

To get this object, run the Get-VBOJob cmdlet.

True

Named

False

BackupItem

Specifies an array of objects. The cmdlet will add them to a list of included objects.

Accepts the VBOBackupItem[] object.

To get this object, run the Get-VBOBackupItem cmdlet.
To create this object, run the New-VBOBackupItem cmdlet.

True

Named

false

False

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see the About CommonParameters section of Microsoft Docs.

Examples

Add-VBOBackupItem Example 1. Adding User Backup Item to Backup Job

This example shows how to add an organization user UserAlpha backup item to the TestJob backup job.

$org = Get-VBOOrganization -Name "ABC Company"

$user = Get-VBOOrganizationUser -Organization $org -DisplayName "UserAlpha"

$backupItemUser = New-VBOBackupItem -User $user -Mailbox:$True -ArchiveMailbox:$False -OneDrive:$False

$job = Get-VBOJob -Name "TestJob"

Add-VBOBackupItem -Job $job -BackupItem $backupItemUser

Perform the following steps:

Run the Get-VBOOrganization cmdlet to get an organization. Save the result to the $org variable.
Run the Get-VBOOrganizationUser cmdlet to get an organization user. In this case we will use it as a backup item. Save the result to the $user variable.
Run the New-VBOBackupItem cmdlet to select the item for the backup job. Save the result to the $backupItemUser variable.
Run the Get-VBOJob cmdlet to select the backup job for modification. Save the result to the $job variable.
Run the Add-VBOBackupItem cmdlet with the $job and $backupItemUser variables to add the selected user to the specified backup job.

Related Commands

Get-VBOBackupItem

Get-VBOJob