--- title: "Start-VBODataRetrieval" description: "This cmdlet creates and starts a retrieval job." canonical: "https://helpcenter.veeam.com/docs/vbo365/powershell/start-vbodataretrieval.html" breadcrumb: "PowerShell Reference > Veeam Backup for Microsoft 365 PowerShell Reference > Data Retrieval > Start-VBODataRetrieval" dateModified: "2026-08-21" --- # Start-VBODataRetrieval ## Short Description Creates and starts retrieval jobs. ::: note Data retrieval is unavailable for Amazon S3 Glacier Instant Retrieval storage class. You can explore and restore data directly from backup copies using Veeam Explorers. ::: ## Syntax This cmdlet provides the following parameter sets:

AzureMailboxParameterSet
``` Start-VBODataRetrieval -RestorePoint -AvailabilityPeriodDays [-Name ] [-Description ] -AzureArchiveRetrievalPolicy [-EnableExpirationNotification] [-ExpirationHoursThreshold ] [-ShowDeleted] [-ShowAllVersions] [-Mailbox ] [] ```
AzureOneDriveParameterSet
``` Start-VBODataRetrieval -RestorePoint -AvailabilityPeriodDays [-Name ] [-Description ] -AzureArchiveRetrievalPolicy [-EnableExpirationNotification] [-ExpirationHoursThreshold ] [-ShowDeleted] [-ShowAllVersions] [-OneDrive ] [] ```
AzureSiteParameterSet
``` Start-VBODataRetrieval -RestorePoint -AvailabilityPeriodDays [-Name ] [-Description ] -AzureArchiveRetrievalPolicy [-EnableExpirationNotification] [-ExpirationHoursThreshold ] [-ShowDeleted] [-ShowAllVersions] [-Site ] [] ```
AzureTeamParameterSet
``` Start-VBODataRetrieval -RestorePoint -AvailabilityPeriodDays [-Name ] [-Description ] -AzureArchiveRetrievalPolicy [-EnableExpirationNotification] [-ExpirationHoursThreshold ] [-ShowDeleted] [-ShowAllVersions] [-Team ] [] ```
AwsMailboxParameterSet
``` Start-VBODataRetrieval -RestorePoint -AvailabilityPeriodDays [-Name ] [-Description ] -AmazonS3GlacierRetrievalPolicy [-EnableExpirationNotification] [-ExpirationHoursThreshold ] [-ShowDeleted] [-ShowAllVersions] [-Mailbox ] [] ```
AwsOneDriveParameterSet
``` Start-VBODataRetrieval -RestorePoint -AvailabilityPeriodDays [-Name ] [-Description ] -AmazonS3GlacierRetrievalPolicy [-EnableExpirationNotification] [-ExpirationHoursThreshold ] [-ShowDeleted] [-ShowAllVersions] [-OneDrive ] [] ```
AwsSiteParameterSet
``` Start-VBODataRetrieval -RestorePoint -AvailabilityPeriodDays [-Name ] [-Description ] -AmazonS3GlacierRetrievalPolicy [-EnableExpirationNotification] [-ExpirationHoursThreshold ] [-ShowDeleted] [-ShowAllVersions] [-Site ] [] ```
AwsTeamParameterSet
``` Start-VBODataRetrieval -RestorePoint -AvailabilityPeriodDays [-Name ] [-Description ] -AmazonS3GlacierRetrievalPolicy [-EnableExpirationNotification] [-ExpirationHoursThreshold ] [-ShowDeleted] [-ShowAllVersions] [-Team ] [] ```

## Detailed Description This cmdlet creates and starts a retrieval job. ## Parameters

Parameter	Description	Type	Required	Position	Accept Pipeline Input
AmazonS3GlacierRetrievalPolicy	Specifies a retrieval policy that you want to use for Amazon S3 Glacier Flexible Retrieval and Amazon S3 Glacier Deep Archive storage classes. The cmdlet will create a retrieval job and apply the specified retrieval policy. You can select the following retrieval policies: `Expedited` `Standard` `Bulk` Note: Data retrieval cost varies depending on the desired speed of the data retrieval process. The `Expedited` policy is unavailable for Amazon S3 Glacier Deep Archive.	`VBOAmazonS3GlacierRetrievalPolicy`	True	Named	False
AvailabilityPeriodDays	Specifies the number of days during which the retrieved backed-up data will be available to explore and restore using Veeam Explorers. Default: 1	`Int32`	True	Named	False
AzureArchiveRetrievalPolicy	Specifies a retrieval policy that you want to use for Azure Blob Storage Archive. The cmdlet will create a retrieval job and apply the specified retrieval policy. You can select the following retrieval policies: `StandardPriority` `HighPriority` Note: Data retrieval cost varies depending on the desired speed of the data retrieval process.	`VBOAzureArchiveRetrievalPolicy`	True	Named	False
Description	Specifies a description of the retrieval job.	`String`	False	Named	False
EnableExpirationNotification	Defines that Veeam Backup for Microsoft 365 will notify you when the availability period is about to end. Default: False	`SwitchParameter`	False	Named	False
ExpirationHoursThreshold	For the `EnableExpirationNotification` option. Specifies how many hours should remain before the retrieved backed-up data expires to send a notification by email.	`Int32`	False	Named	False
Mailbox	Specifies an array of mailboxes whose backed-up data you want to retrieve. The cmdlet will create and start a retrieval job to retrieve data for these mailboxes.	`VBOMailboxData[]`	False	Named	False
Name	Specifies a retrieval job name. The cmdlet will add a retrieval job with this name.	`String`	False	Named	False
OneDrive	Specifies an array of OneDrives whose backed-up data you want to retrieve. The cmdlet will create and start a retrieval job to retrieve data for these OneDrives.	`VBOOneDriveData[]`	False	Named	False
RestorePoint	Specifies a restore point stored in Veeam Backup for Microsoft 365 for the object storage repository that was specified as a target for backup copy jobs. The cmdlet will create and start a retrieval job to retrieve backed-up data from this restore point. Accepts the `VBORestorePoint` object. To get this object, run the `Get-VBORestorePoint` cmdlet.	`VBORestorePoint`	True	Named	True (ByValue)
ShowAllVersions	Defines that Veeam Backup for Microsoft 365 will retrieve all versions of items that have been modified by user before the specified date. Default: False	`SwitchParameter`	False	Named	False
ShowDeleted	Defines that Veeam Backup for Microsoft 365 will retrieve items that have been removed by user before the specified date. Default: False	`SwitchParameter`	False	Named	False
Site	Specifies an array of SharePoint sites whose backed-up data you want to retrieve. The cmdlet will create and start a retrieval job to retrieve data for these sites.	`VBOSiteData[]`	False	Named	False
Team	Specifies an array of teams whose backed-up data you want to retrieve. The cmdlet will create and start a retrieval job to retrieve data for these teams.	`VBOTeamData[]`	False	Named	False

`` This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see the [About Common Parameters](http://go.microsoft.com/fwlink/p/?LinkID=113216) section of Microsoft Learn. ## Output Object The cmdlet returns the [`VBODataRetrieval`](vbodataretrieval.md) object that contains settings for a retrieval job. ## Examples ::: example ### Starting Retrieval Job to Retrieve Mailbox Data This example shows how to create and start the retrieval job that will retrieve mailbox data from Azure Blob Storage Archive. ``` $repository = Get-VBORepository -Name "Azure Archive Storage" $mailbox = Get-VBOEntityData -Repository $repository -Type Mailbox -Name "User Mailbox" $restorepoint = Get-VBORestorePoint -Repository $repository -Latest Start-VBODataRetrieval -RestorePoint $restorepoint -AvailabilityPeriodDays 5 -AzureArchiveRetrievalPolicy HighPriority -Name "ABC User Mailbox" -EnableExpirationNotification -ExpirationHoursThreshold 2 -Mailbox $mailbox ``` Perform the following steps: 1. Run the [`Get-VBORepository`](get-vborepository.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$repository` variable. 2. Run the [`Get-VBOEntityData`](get-vboentitydata.md) cmdlet. Set the `$repository` variable as the `Repository` parameter value. Specify the `Type` parameter value. Specify the `Name` parameter value. Save the result to the `$mailbox` variable. 3. Run the [`Get-VBORestorePoint`](get-vborestorepoint.md) cmdlet. Set the `$repository` variable as the `Repository` parameter value. Provide the `Latest` parameter. Save the result to the `$restorepoint` variable. 4. Run the `Start-VBODataRetrieval` cmdlet. Specify the following settings: - Set the `$restorepoint` variable as the `RestorePoint` parameter value. - Specify the `AvailabilityPeriodDays` parameter value. - Specify the `AzureArchiveRetrievalPolicy` parameter value. - Specify the `Name` parameter value. - Provide the `EnableExpirationNotification` parameter. - Specify the `ExpirationHoursThreshold` parameter value. - Set the `$mailbox` variable as the `Mailbox` parameter value. ::: ## Related Commands - [`Get-VBOEntityData`](get-vboentitydata.md) - [`Get-VBORepository`](get-vborepository.md) - [`Get-VBORestorePoint`](get-vborestorepoint.md)