Save-VBRNASBackupFLRItem (obsolete)

Short Description

Restores objects backed up by file backup jobs to the specified file shares.

Note

This cmdlet is obsolete. Run the Save-VBRUnstructuredBackupFLRItemRestores objects backed up by file backup jobs or object storage backup jobs to the specified file shares or object storage. cmdlet instead.

Product Edition: Standard, Enterprise, Enterprise Plus, Veeam Universal License

Syntax

Save-VBRNASBackupFLRItem -Item <VBRNASBackupFLRItem[]> [-PreservePermissions] -Server <VBRNASServer>

-Path <String> [-RunAsync] [<CommonParameters>]

Detailed Description

This cmdlet restores objects backed up by file backup jobs to the specified file shares.

Parameters

Parameters

Parameter

Description

Type

Required

Position

Accept Pipeline Input

Item

Specifies an array of backed-up object. The cmdlet will restore these objects to the file share.

VBRNASBackupFLRItem[]

True

Named

True (ByPropertyName, ByValue)

Path

Specifies a path on a file share. The cmdlet will restore the backed-up object to that path.

String

True

Named

False

PreservePermissions

Defines that the cmdlet will restore permissions and security attributes of objects that you want to save.

If you provide this parameter, the cmdlet will restore backup files with security attributes and permissions set by the user. Otherwise, permissions and security attributes of restored backups will not be recovered.

SwitchParameter

False

Named

False

RunAsync

Defines that the command returns immediately without waiting for the task to complete.

SwitchParameter

False

Named

False

Server

Specifies a file share. The cmdlet will restore the backed-up object to this file share.

Accepts the VBRNASServer object. To get this object, run the Get-VBRNASServerReturns file shares that are added to the Veeam Backup & Replication infrastructure. This cmdlet is obsolete. Run the Get-VBRUnstructuredServer cmdlet instead. cmdlet.

VBRNASServer

True

Named

False

<CommonParameters>

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see Microsoft Docs.

Output Object

The cmdlet returns the VBRNASBackupFLRItem and VBRNASBackupFLRFolder objects that contain settings of restored guest OS files and folders that have been backed up by file backup jobs.

Examples

Save-VBRNASBackupFLRItem (obsolete)Example 1. Restoring All Objects to File Shares

This example shows how to restore all backed-up files and folders to the \\WinSrv\Reports file share. Veeam Backup & Replication will save files and folders to the \\WinSrv\Reports\Restored folder on the file share.

$session = Get-VBRNASBackupFLRSession

$fileshare = Get-VBRNASServer -Name "\\WinSrv\Reports"

$file = Get-VBRNASBackupFLRItem -Session $session

Save-VBRNASBackupFLRItem -Item $file -Server $fileshare -Path "\\WinSrv\Reports\Restored"

Perform the following steps:

  1. Run the Get-VBRNASBackupFLRSessionReturns restore sessions started to recover backups created by file backup jobs. This cmdlet is obsolete. Run the Get-VBRUnstructuredBackupFLRSession cmdlet instead. cmdlet. Save the result to the $session variable.
  2. Run the Get-VBRNASServerReturns file shares that are added to the Veeam Backup & Replication infrastructure. This cmdlet is obsolete. Run the Get-VBRUnstructuredServer cmdlet instead. cmdlet. Specify the Name parameter value. Save the result to the $fileshare variable.
  3. Run the Get-VBRNASBackupFLRItemReturns backed-up objects created by file backup jobs. This cmdlet is obsolete. Run the Get-VBRUnstructuredBackupFLRItem cmdlet instead. cmdlet. Set the $session variable as the Session parameter value. Save the result to the $file variable.
  4. Run the Save-VBRNASBackupFLRItem cmdlet. Specify the following settings:
    • Set the $file variable as the Item parameter value.
    • Set the $fileshare variable as the Server parameter value.
    • Specify the Path parameter value.

Save-VBRNASBackupFLRItem (obsolete)Example 2. Restoring Specific Folder to File Shares

This example shows how to restore the October Reports folder to the \\WinSrv\Reports file share. Veeam Backup & Replication will save files and folders to the \\WinSrv\Reports\Restored folder on the file share.

$session = Get-VBRNASBackupFLRSession

$fileshare = Get-VBRNASServer -Name "\\WinSrv\Reports"

$files = Get-VBRNASBackupFLRItem -Session $session -Name "October Reports"

Save-VBRNASBackupFLRItem -Item $files -Server $fileshare -Path "\\WinSrv\Reports\Restored"

Perform the following steps:

  1. Run the Get-VBRNASBackupFLRSessionReturns restore sessions started to recover backups created by file backup jobs. This cmdlet is obsolete. Run the Get-VBRUnstructuredBackupFLRSession cmdlet instead. cmdlet. Save the result to the $session variable.
  2. Run the Get-VBRNASServerReturns file shares that are added to the Veeam Backup & Replication infrastructure. This cmdlet is obsolete. Run the Get-VBRUnstructuredServer cmdlet instead. cmdlet. Specify the Name parameter value. Save the result to the $fileshare variable.
  3. Run the Get-VBRNASBackupFLRItemReturns backed-up objects created by file backup jobs. This cmdlet is obsolete. Run the Get-VBRUnstructuredBackupFLRItem cmdlet instead. cmdlet. Set the $session variable as the Session parameter value. Specify the Name parameter value. Save the result to the $files variable.
  4. Run the Save-VBRNASBackupFLRItem cmdlet. Specify the following settings:
    • Set the $files variable as the Item parameter value.
    • Set the $fileshare variable as the Server parameter value.
    • Specify the Path parameter value.
  • Get-VBRNASBackupFLRSessionReturns restore sessions started to recover backups created by file backup jobs. This cmdlet is obsolete. Run the Get-VBRUnstructuredBackupFLRSession cmdlet instead.
  • Get-VBRNASServerReturns file shares that are added to the Veeam Backup & Replication infrastructure. This cmdlet is obsolete. Run the Get-VBRUnstructuredServer cmdlet instead.
  • Get-VBRNASBackupFLRItemReturns backed-up objects created by file backup jobs. This cmdlet is obsolete. Run the Get-VBRUnstructuredBackupFLRItem cmdlet instead.

Page updated 2026-08-19

Page content applies to build 13.1.1.18