This is an archive version of the document. To get the most up-to-date information, see the current version.

Add-VBOBackupItem

In this article

Short Description

Adds a list of objects to a backup job.

Syntax

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

Detailed Description

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

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 type. 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 type.

False

Named

false

False

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see Microsoft Docs.

Example

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

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

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

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

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

$job = Get-VBOJob -Name "TestJob"

Add-VBOBackupItem -Job $job -BackupItem $backupItemUser

Related Commands