Set-VBOBackupItem

Short Description

Modifies organization object settings.

Syntax

Set-VBOBackupItem -BackupItem <VBOBackupItem[]> [-Mailbox] [-ArchiveMailbox] [-OneDrive] [-Sites]

[-GroupMailbox] [-GroupSite] [-Teams] [-TeamsChats] [<CommonParameters>]

Detailed Description

This cmdlet modifies organization object settings. To modify settings, you need to enter the necessary parameters with new values. The parameters that you omit will remain unchanged.

Parameters

Parameters
Parameter	Description	Type	Required	Position	Accept Pipeline Input
ArchiveMailbox	Defines that the cmdlet will enable the archive mailbox option for an object. Default: False Note: You cannot specify this parameter for the user of the `PublicMailbox` type.	`SwitchParameter`	False	Named	False
BackupItem	Specifies an organization object. The cmdlet will modify settings of this object. Accepts the `VBOBackupItem[]` object. To get this object, run the `Get-VBOBackupItem` cmdlet.	`VBOBackupItem[]`	True	Named	False
GroupMailbox	Defines that the cmdlet will enable the group mailbox option for an object. Default: False	`SwitchParameter`	False	Named	False
GroupSite	Defines that the cmdlet will enable the group site option for an object. Default: False	`SwitchParameter`	False	Named	False
Mailbox	Defines that the cmdlet will enable the mailbox option for an object. Default: False	`SwitchParameter`	False	Named	False
OneDrive	Defines that the cmdlet will enable the OneDrive option for an object. Default: False Note: You cannot specify this parameter for the user of the `PublicMailbox` type.	`SwitchParameter`	False	Named	False
Sites	Defines that the cmdlet will enable the sites option for an object. Default: False	`SwitchParameter`	False	Named	False
Teams	Defines that the cmdlet will enable the teams option for an object. Default: False	`SwitchParameter`	False	Named	False
TeamsChats	Defines that the cmdlet will enable the team posts (formerly team chats) option for an object. Default: False	`SwitchParameter`	False	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

Modifying Processing Options of User Backup Item

This example shows how to add all processing options except for the mailbox for a backup item with a user named userAlpha.

$org = Get-VBOOrganization -Name "ABC"

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

$backupitem = New-VBOBackupItem -User $user -Mailbox -ArchiveMailbox -OneDrive -Sites

Set-VBOBackupItem -BackupItem $backupitem -Mailbox:$false -ArchiveMailbox -OneDrive -Sites

Perform the following steps:

Run the Get-VBOOrganization cmdlet with the Name parameter to get the organization with the name ABC. Save the result to the $org variable.
Run the Get-VBOOrganizationUser cmdlet with the $org variable and the userAlpha value for the DisplayName parameter to get a user with the display name userAlpha. Save the result to the $user variable.
Run the New-VBOBackupItem cmdlet with the $user variable as the User parameter value and Mailbox, ArchiveMailbox, OneDrive and Sites parameters. Save the result to the $backupitem variable.
Run the Set-VBOBackupItem cmdlet with the $backupitem variable as the BackupItem parameter value, ArchiveMailbox, OneDrive and Sites parameters, and the false value for the Mailbox parameter to create a backup item with all userAlpha processing options except for the mailbox.