Get-VBOBackupItem

Short Description

Returns a list of objects included in a backup job.

Syntax

Get-VBOBackupItem -Job <VBOJob> [-Name <String>] [-Organization <SwitchParameter>] [-Users <SwitchParameter>] [-Groups <SwitchParameter>] [-Sites <SwitchParameter>] [-PersonalSites <SwitchParameter>] [-TeamsGroups <SwitchParameter>] [<CommonParameters>]

Detailed Description

This cmdlet returns an array of objects included in a backup job. The job will back up these objects.

Parameters

Parameter	Description	Type	Required	Position	Accept Pipeline Input	Accept Wildcard Characters
Job	Specifies a backup job. The cmdlet will return objects included in this backup job.	Accepts the VBOJob object. To get this object, run the Get-VBOJob cmdlet.	True	Named	False	False
Name	Specifies a name of an object that is added to a backup job. The cmdlet will return objects with this name. Note: If you want to get a specific type of an object, you must also set either of the following parameters: Organization Users Groups Sites PersonalSites TeamsGroups	String	False	Named	False	False
Organization	Defines that the cmdlet will return an organization included in a backup job.	SwitchParameter	False	Named	False	False
Users	Defines that the cmdlet will return users included in a backup job.	SwitchParameter	False	Named	False	False
Groups	Defines that the cmdlet will return groups included in a backup job.	SwitchParameter	False	Named	False	False
Sites	Defines that the cmdlet will return sites included in a backup job.	SwitchParameter	False	Named	False	False
PersonalSites	Defines that the cmdlet will return personal sites included in a backup job.	SwitchParameter	False	Named	False	False
TeamsGroups	Defines that the cmdlet will return teams included in a backup job.	SwitchParameter	False	Named	False	False

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

Output Object

The cmdlet returns the VBOBackupItem[] object that contains an array of objects included in a backup job.

Examples

Get-VBOBackupItem Example 1. Getting All Objects from Backup Job

This example shows how to get all objects that are included in the Monthly Backup job.

$job = Get-VBOJob -Name "Monthly Backup"

Get-VBOBackupItem -Job $job

Perform the following steps:

Run the Get-VBOJob cmdlet. Specify the Name parameter value. Save the result to the $job variable.
Run the Get-VBOBackupItem cmdlet. Set the $job variable as the Job parameter value.

Get-VBOBackupItem Example 2. Getting Groups from Backup Job

This example shows how to get all groups that are included in the Monthly Backup job.

$job = Get-VBOJob -Name "Monthly Backup"

Get-VBOBackupItem -Job $job -Groups

Perform the following steps:

Run the Get-VBOJob cmdlet. Specify the Name parameter value. Save the result to the $job variable.
Run the Get-VBOBackupItem cmdlet. Set the $job variable as the Job parameter value. Provide the Groups parameter.

Get-VBOBackupItem Example 3. Getting Details on Specific Group from Backup Job

This example shows how to get all details of the Team05 group that is included in the Monthly Backup job.

$job = Get-VBOJob -Name "Monthly Backup"

$group = Get-VBOBackupItem -Job $job -Groups

$group.Group

OrganizationId : 95141aac-d881-4ba4-b45e-717b0bdfc6ae

OfficeId : 027f137b-33c0-4be8-a0e0-1263db7f27c2

OnPremisesId : 00000000-0000-0000-0000-000000000000

DisplayName : Team05

GroupName : Team05@Atlanta360.tech

Type : Office365

Perform the following steps:

Run the Get-VBOJob cmdlet. Specify the Name parameter value. Save the result to the $job variable.
Run the Get-VBOBackupItem cmdlet. Set the $job variable as the Job parameter value. Provide the Groups parameter. Save the result to the $group variable.
Set the Group property as the $group variable. The object will return the following details on the group: OrganizationId, OfficeId, OnPremisesId, DisplayName, GroupName, Type.

Get-VBOBackupItem Example 4. Getting Name of Specific Group from Backup Job

This example shows how to get a name of the Team05 group that is included in the Monthly Backup job.

$job = Get-VBOJob -Name "Monthly Backup"

$group = Get-VBOBackupItem -Job $job -Groups

$group.Group.GroupName

GroupName: Team05@Atlanta360.tech

Perform the following steps:

Run the Get-VBOJob cmdlet. Specify the Name parameter value. Save the result to the $job variable.
Run the Get-VBOBackupItem cmdlet. Set the $job variable as the Job parameter value. Provide the Groups parameter. Save the result to the $group variable.
Set the Group.GroupName property as the $group variable. The object will return the information on the GroupName property.

Related Commands

Get-VBOJob