Get-VBODataRetrieval

Short Description

Returns retrieval jobs.

Syntax

This cmdlet provides the following parameter sets:

  • ByIdParameterSet

    Get-VBODataRetrieval -Id <Guid> [<CommonParameters>]

  • AllParameterSet

    Get-VBODataRetrieval [-Repository <VBORepository>] [-Organization <VBOOrganization>]

    [-DataState <VBODataRetrievalDataState>] [<CommonParameters>]

Detailed Description

This cmdlet returns retrieval jobs configured in Veeam Backup for Microsoft 365.

Run the Get-VBODataRetrievalSessionReturns data retrieval sessions. cmdlet to get retrieval job IDs.

Parameters

Parameters

Parameter

Description

Type

Required

Position

Accept Pipeline Input

DataState

Specifies a status of the backed-up data. The cmdlet will return retrieval jobs in which data has the specified status. You can select the following statuses:

  • Retrieving
  • Retrieved
  • ChangingAvailabilityPeriod
  • Removing

VBODataRetrievalDataState

False

Named

False

Id

Specifies an ID of the retrieval job. The cmdlet will return the retrieval job with this ID.

Guid

True

Named

False

Organization

Specifies a Microsoft organization. The cmdlet will return retrieval jobs for backed-up data of objects from 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

False

Named

False

Repository

Specifies the object storage repository that was specified as a target for backup copy jobs. The cmdlet will return retrieval jobs for backed-up data stored in this object storage repository.

Accepts the VBORepository object.

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

VBORepository

False

Named

True (ByValue)

<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 VBODataRetrieval object that contains settings for a retrieval job.

Examples

Get-VBODataRetrievalExample 1: Getting Retrieval Job by ID

This command returns a retrieval job by ID.

Get-VBODataRetrieval -Id f5fda89f-40a2-4d1c-8e05-f6bba94b6c50

Get-VBODataRetrievalExample 2: Getting Retrieval Job by Backup Repository and Data Status

This example shows how to get a list of retrieval jobs in which backed-up data is stored in the Azure Archive Storage object storage repository and has the Retrieved status.

$repository = Get-VBORepository -Name "Azure Archive Storage"

Get-VBODataRetrieval -Repository $repository -DataState Retrieved

Perform the following steps:

  1. Run the Get-VBORepositoryReturns backup repositories. cmdlet. Specify the Name parameter value. Save the result to the $repository variable.
  2. Run the Get-VBODataRetrieval cmdlet. Set the $repository variable as the Repository parameter value. Specify the DataState parameter value.

Page updated 2026-08-21

Page content applies to build 8.6.0.1102