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.

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 items if you schedule them to run within the same period. If their schedules overlap, the items will be backed up by the job that starts earlier.
If you add an object that has already been added to the backup job again, a new object will replace the old object.

Parameters

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

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. It will be used 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.