New-VBOBackupItem

Short Description

Creates organization objects.

Syntax

This cmdlet provides parameter sets that allow you to:

  • Create objects that represent users.

New-VBOBackupItem -User <VBOOrganizationUser[]> [-Mailbox <SwitchParameter>] [-ArchiveMailbox <SwitchParameter>] [-OneDrive <SwitchParameter>] [-Sites <SwitchParameter>] [<CommonParameters>]

  • Create objects that represent organizations.

New-VBOBackupItem -Organization <VBOOrganization[]> [-Mailbox <SwitchParameter>] [-ArchiveMailbox <SwitchParameter>] [-OneDrive <SwitchParameter>] [-Sites <SwitchParameter>] [-Teams <SwitchParameter>] [-TeamsChats <SwitchParameter>] [<CommonParameters>]

  • Create objects that represents sites.

New-VBOBackupItem -Site <VBOOrganizationSite[]>  [<CommonParameters>]

  • Create objects that represent groups.

New-VBOBackupItem -Group <VBOOrganizationGroup[]> [-Mailbox <SwitchParameter>] [-ArchiveMailbox <SwitchParameter>] [-OneDrive <SwitchParameter>] [-Sites <SwitchParameter>] [-GroupMailbox <SwitchParameter>] [-GroupSite <SwitchParameter>] [<CommonParameters>]

  • Create objects that represent personal sites.

New-VBOBackupItem -PersonalSites <SwitchParameter> [<CommonParameters>]

  • Create objects that represent teams.

New-VBOBackupItem -Team <VBOOrganizationTeam[]> [-TeamsChats <SwitchParameter>] [<CommonParameters>]

Detailed Description

Creates organization objects. You can add or exclude these objects from a backup job.

For more information on object types, see the Organization Object Types section of the Veeam Backup for Microsoft 365 User Guide.

Run the Add-VBOBackupItem cmdlet to create a list of objects included in a backup job. The job will back up these objects.

Run the Add-VBOExcludedBackupItem cmdlet to create a list of objects excluded from a backup job. The job will exclude these objects from backup.

Parameters

Parameter

Description

Type

Required

Position

Accept Pipeline Input

Accept Wildcard Characters

Organization

Specifies an array of organizations added to Veeam Backup for Microsoft 365. The cmdlet will create an organization object that contains an organization.

Accepts the VBOOrganization object.

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

True

Named

False

False

User

Specifies an array of users added to Veeam Backup for Microsoft 365. The cmdlet will create an organization object that contains a user.

Accepts the VBOOrganizationUser object.

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

True

Named

False

False

Group

Specifies an array of groups added to Veeam Backup for Microsoft 365. The cmdlet will create an organization object that contains a group.

Accepts the VBOOrganizationGroup object.

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

True

Named

False

False

Site

Specifies an array of sites added to Veeam Backup for Microsoft 365. The cmdlet will create an organization object that contains a site.

Accepts the VBOOrganizationSite object.

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

True

Named

False

False

Team

Specifies an array of teams added to Veeam Backup for Microsoft 365. The cmdlet will create an organization object that contains a team.

Accepts the VBOOrganizationTeam object.

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

True

Named

False

False

PersonalSites

Defines that the cmdlet will create an organization object with the personal sites option enabled.

SwitchParameter

True

Named

False

False

OneDrive

Defines that the cmdlet will create an organization object that will have the OneDrive option enabled.

Note: You cannot specify this parameter for the PublicMailbox type of the user.

SwitchParameter

False

Named

False

False

Mailbox

Defines that the cmdlet will create an organization object that will have the mailbox option enabled.

SwitchParameter

False

Named

False

False

ArchiveMailbox

Defines that the cmdlet will create an organization object that will have the archived mailbox option enabled.

Note: You cannot specify this parameter for the PublicMailbox type of the user.

SwitchParameter

False

Named

False

False

Sites

Defines that the cmdlet will create an organization object that will have the sites option enabled.

SwitchParameter

False

Named

False

False

Teams

Defines that the cmdlet will create an organization object that will have the teams option enabled.

SwitchParameter

False

Named

False

False

TeamsChats

Defines that the cmdlet will create an organization object that will have the team chats option enabled.

SwitchParameter

False

Named

False

False

GroupMailbox

Defines that the cmdlet will create an organization object that will have the group mailbox enabled.

SwitchParameter

False

Named

False

False

GroupSite

Defines that the cmdlet will create an organization object that will have the group site option enabled.

SwitchParameter

False

Named

False

False

<CommonParameters>

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

Examples

New-VBOBackupItemExample 1. Creating User Object

This example shows how to create an organization object that contains a user. An object will be created with the following settings:

  • The object will contain the William Sonders user.
  • The object will have all options enabled except for the mailbox.

$org = Get-VBOOrganization -Name "ABC"

$user = Get-VBOOrganizationUser -Organization $org -DisplayName "William Sonders"

New-VBOBackupItem -User $user -Mailbox:$false -ArchiveMailbox -OneDrive -Sites

Perform the following steps:

  1. Run the Get-VBOOrganization cmdlet. Set ABC as the Name parameter value. Save the result to the $org variable.
  2. Run the Get-VBOOrganizationUser cmdlet. Set the $org variable as the Organization parameter value. Set William Sonders as the DisplayName parameter value. Save the result to the $user variable.
  3. Run the New-VBOBackupItem cmdlet. Specify the following settings:
  • Set the $user variable as the User parameter value.
  • Set the ArchiveMailbox, OneDrive and Sites parameters.
  • Set :$false as the Mailbox parameter value.

New-VBOBackupItemExample 2. Creating Object with Mailbox, Archive Mailbox, Teams, Team Chats and Sites

This example shows how to create a backup item with an organization ABC mailbox, archive mailbox and all of the sites, teams and team chats but without the OneDrive processing option.

$org = Get-VBOOrganization -Name "ABC"

New-VBOBackupItem -Organization $org -Mailbox -ArchiveMailbox -OneDrive$:false -Sites -Teams -TeamsChats

Perform the following steps:

  1. Run the Get-VBOOrganization cmdlet with the Name parameter to get the organization with the name ABC. Save the result to the $org variable.
  2. Run the New-VBOBackupItem cmdlet with the $org variable as the Organization parameter value, the Mailbox, Archive Mailbox, Sites, Teams and TeamsChats parameters, and the :$false value for the OneDrive parameter to create a backup item with all ABC organization processing options except for the OneDrive components.

New-VBOBackupItemExample 3. Creating Site Object

This example shows how to create a backup item with an ABC organization site with a given URL.

$org = Get-VBOOrganization -Name "ABC"

$siteUrl = "https://exampleorganization.sharepoint.com/sites/exampleparentsite"

$site = Get-VBOOrganizationSite -Organization $org -URL $siteUrl

New-VBOBackupItem -Site $site

Perform the following steps:

  1. Run the Get-VBOOrganization cmdlet with the Name parameter to get the organization with the name ABC. Save the result to the $org variable.
  2. Save a certain SharePoint organization site URL address to the $siteUrl variable.
  3. Run the Get-VBOOrganizationSite cmdlet with the $org variable and the $siteURL variable as the URL parameter value to get an ABC organization site. Save the result to the $site variable.
  4. Run the New-VBOBackupItem cmdlet with the $site variable to create a backup item with ABC organization site with a given URL.

New-VBOBackupItemExample 4. Creating Group Object

This example shows how to create a backup item with all processing options for the UsersAlpha organization user group.

$org = Get-VBOOrganization -Name "ABC"

$group = Get-VBOOrganizationGroup -Organization $org -DisplayName "UsersAlpha"

New-VBOBackupItem -Group $group -Mailbox -ArchiveMailbox -OneDrive -Sites -GroupMailbox -GroupSite

Perform the following steps:

  1. Run the Get-VBOOrganization cmdlet with the Name parameter to get the organization with the name ABC. Save the result to the $org variable.
  2. Run the Get-VBOOrganizationGroup cmdlet with the $org variable and the UsersAlpha value for the DisplayName parameter to get an organization user group with the display name UsersAlpha. Save the result to the $group variable.
  3. Run the New-VBOBackupItem cmdlet with the $group variable as the Group parameter value and the Mailbox, ArchiveMailbox, OneDrive, Sites, GroupMailbox and GroupSite parameters to create a backup item with all processing options for the UsersAlpha organization user group.

New-VBOBackupItemExample 5. Creating Object to Process Personal Sites

This command creates a backup item with the PersonalSites processing option.

New-VBOBackupItem -PersonalSites

New-VBOBackupItemExample 6. Creating Object to Process Team with Team Chats

This example shows how to create a backup item with the TeamsChats processing option for a team with the display name IT.

$org = Get-VBOOrganization -Name "ABC"

$team = Get-VBOOrganizationTeam -Organization $org -DisplayName "IT"

New-VBOBackupItem -Team $team -TeamsChats

Perform the following steps:

  1. Run the Get-VBOOrganization cmdlet with the Name parameter to get the organization with the name ABC. Save the result to the $org variable.
  2. Run the Get-VBOrganizationTeam cmdlet. Set the $org variable as the Organization parameter value. Specify the DisplayName parameter value. Save the result to the $team variable.
  3. Run the New-VBOBackupItem cmdlet with the $team variable as the Team parameter value and the TeamsChats parameter to create a backup item to process the IT team with team chats.

Related Commands