Get-VBOUsageData

Short Description

Returns information on the used space in backup repositories.

Syntax

This cmdlet provides the following parameter sets:

  • ByRepositoryParameterSet

    Get-VBOUsageData -Repository <VBORepository> [<CommonParameters>]

  • ByOrganizationAndRepositoryParameterSet

    Get-VBOUsageData -Repository <VBORepository> -Organization <VBOOrganization> [<CommonParameters>]

  • ByOrganizationParameterSet

    Get-VBOUsageData -Organization <VBOOrganization> [<CommonParameters>]

Detailed Description

This cmdlet returns a representation entity of a used repository space by an organization or a representation of an organizations used data space in all used backup repositories.

Parameters

Parameters

Parameter

Description

Type

Required

Position

Accept Pipeline Input

Organization

Specifies a Microsoft organization. The cmdlet will return information on data usage by this organization.

Accepts the VBOOrganization object.

To get this object, run the Get-VBOOrganizationReturns Microsoft organizations added to the Veeam Backup for Microsoft 365 infrastructure. cmdlet.

VBOOrganization

True

Named

False

Repository

Specifies a backup repository. The cmdlet will return information on data usage in this backup repository.

Accepts the VBORepository object.

To get this object, run the Get-VBORepositoryReturns backup repositories. cmdlet.

VBORepository

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.

Output Object

The cmdlet returns the VBOUsageData object that contains details on the used space in a backup repository.

Examples

Get-VBOUsageDataExample 1: Getting Information About Data Usage on Specific Backup Repository

This example shows how to get information on the data usage for a backup repository with the name Repository1.

$repository = Get-VBORepository -Name "Repository1"

Get-VBOUsageData -Repository $repository

Perform the following steps:

  1. Run the Get-VBORepositoryReturns backup repositories. cmdlet with the Name parameter to get a backup repository with the name Repository1. Save the result to the $repository variable.
  2. Run the Get-VBOUsageData cmdlet with the $repository variable to get the data usage information for the specified repository.

Get-VBOUsageDataExample 2: Getting Information About Data Usage by Specific Organization

This example shows how to get information on the data usage by an organization with the name Organization1 in a backup repository with the name Repository1.

$repository = Get-VBORepository -Name "Repository1"

$organization = Get-VBOOrganization -Name "Organization1"

Get-VBOUsageData -Repository $repository -Organization $organization

Perform the following steps:

  1. Run the Get-VBORepositoryReturns backup repositories. cmdlet with the Name parameter to get to get a backup repository with the name Repository1. Save the result to the $repository variable.
  2. Run the Get-VBOOrganizationReturns Microsoft organizations added to the Veeam Backup for Microsoft 365 infrastructure. cmdlet with the Name parameter to get an organization with the name Organization1. Save the result to the $organization variable.
  3. Run the Get-VBOUsageData cmdlet with the $repository and $organization variables to get the data usage information.

Get-VBOUsageDataExample 3: Getting Information About Data Usage

This example shows how to get information on the data usage by an organization with the name Organization1.

$organization = Get-VBOOrganization -Name "Organization1"

Get-VBOUsageData -Organization $organization

Perform the following steps:

  1. Run the Get-VBOOrganizationReturns Microsoft organizations added to the Veeam Backup for Microsoft 365 infrastructure. cmdlet with the Name parameter to get an organization with the name Organization1. Save the result to the $organization variable.
  2. Run the Get-VBOUsageData cmdlet with the $organization variable to get the data usage information.

Page updated 2026-08-21

Page content applies to build 8.6.0.1102