This is an archive version of the document. To get the most up-to-date information, see the current version.

Downloading Backups from Microsoft OneDrive

You can download backups created with Veeam Agent for Microsoft Windows and stored on a Microsoft OneDrive storage. This may be useful before you upgrade to Veeam Agent for Microsoft Windows 6.0. In this Veeam Agent version, backup to Microsoft OneDrive will be deprecated.

You can use the command line interface to download Veeam Agent backups from a Microsoft OneDrive storage. After the download operation starts, Veeam Agent performs the following operations:

Searches for backup jobs targeted at a Microsoft OneDrive storage. If the jobs are found, Veeam Agent scans the storage and displays the list of backups you can download.

NOTE

If you have several backup jobs targeted at a Microsoft OneDrive storage that were configured using different Microsoft OneDrive accounts, Veeam Agent displays backups created by backup jobs that were configured with only one of the accounts: the account used last to sign in to Microsoft OneDrive. For example, in the New Backup Job wizard. To learn more about authorization, see Authorization in Microsoft OneDrive.

Downloads the backup you selected.

Keep in mind the following:

When downloading, Veeam Agent transforms data blocks stored a Microsoft OneDrive storage into the usual backup files: VBK, VIB and VBM. To learn more, see Types of Backup Files.
You cannot download individual restore point or backup chain. Veeam Agent always downloads all files of the selected backup that are available on a Microsoft OneDrive storage.

Downloading Backups with Command Line Interface

To download a Veeam Agent backup, use a command with the following syntax:

"C:\Program Files\Veeam\Endpoint Backup\Veeam.EndPoint.Manager.exe" /downloadbackup "<path>"

where <path> — path to the target folder where Veeam Agent will save the downloaded backup.

If Veeam Agent finds backups that you can download from a Microsoft OneDrive storage, Veeam Agent provides a numbered list of these backups. You can select the backup you want to download using number keys on your keyboard.

If the download operation is completed successfully, Veeam Agent will display a confirmation. If the download operation fails for some reason, you can retry to download the backup. To learn more, see Resuming Download.

Keep in mind, Veeam Agent does not delete backup files that are partly downloaded. As a result, to re-download the backup from scratch, you must delete the partly downloaded backup files from the target folder or select another target folder with the <path> parameter.

Resuming Download

You can instruct Veeam Agent to resume the download operation that was previously interrupted using the /reload parameter.

During download resume, Veeam Agent uses digests with data block metadata to compare partly downloaded backup files on your computer with data blocks stored on a Microsoft OneDrive storage. Such approach allows Veeam Agent to detect data blocks that were already downloaded and continue the download operation from the point where it was interrupted.

IMPORTANT

Before you resume the download operation, make sure that the specified folder contains at least one partly downloaded backup. If the folder is empty or contains only fully downloaded backups, the download operation may fail.

To resume the download operation, use a command with the following syntax:

"C:\Program Files\Veeam\Endpoint Backup\Veeam.EndPoint.Manager.exe" /downloadbackup /reload "<path>"

where <path> — path to the folder where you store partly downloaded backup.

If you have several backups stored on a Microsoft OneDrive storage, Veeam Agent provides a numbered list of these backups. You can select the backup you want to resume downloading using number keys on your keyboard.