Save-VBREntraIDLogsBackupFLRItem

Short Description

Restores files and folders backed up by a log backup job that protects Microsoft Entra ID audit and sign-in logs.

Applies to

Product Edition: Enterprise Plus, Veeam Universal License

Syntax

Save-VBREntraIDLogsBackupFLRItem -Server <VBRNASServer> -Item <VBREntraIDLogsBackupFLRItem[]> -Path <String> [-RunAsync] [<CommonParameters>]

Detailed Description

This cmdlet restores and saves files and folders backed up by a log backup job.

Parameters

Parameter

Description

Type

Required

Position

Accept
Pipeline
Input

Item

Specifies an array of Entra ID log files and folders that you want to restore.

Accepts the VBREntraIDLogsBackupFLRItem[] object. To get this object, run the Get-VBREntraIDLogsBackupFLRItem cmdlet.

True

Named

True (ByPropertyName, ByValue)

Server

Specifies the file share to which you want to restore log files or folders.

Accepts the VBRNASServer object. To get this object, run the Get-VBRUnstructuredServer cmdlet.

True

Named

False

Path

Specifies the path to the folder where you want to restore log files or folders.

String

True

Named

False

RunAsync

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

SwitchParameter

False

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 array of VBREntraIDLogsBackupFLRItem objects that contain settings of restored log files and folders.

Examples

This example shows how to restore the log files whose names start with 2024-11-01T10. The files are restored to the \\WinSrv\Reports file share to the \\WinSrv\Reports\Restored folder.

$tenant = Get-VBREntraIdTenant -AzureTenantId "xxxxx"

$logBackups = Get-VBREntraIDLogsBackup

$logRestoreSession = Start-VBREntraIDLogsBackupFLRSession -Backup $logBackups[0] -Tenant $tenant

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

$files = Get-VBREntraIDLogsBackupFLRItem -Session $logRestoreSession -Name "2024-11-01T10*" -Recurse

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

Perform the following steps:

  1. Run the Get-VBREntraIdTenant cmdlet. Specify the AzureTenantId parameter value. Save the result to the $tenant variable.
  2. Run the Get-VBREntraIDLogsBackup cmdlet.

The Get-VBREntraIDLogsBackup cmdlet will return an array of backups. Mind the ordinal number of the necessary restore point, for arrays it starts with 0. In our example, it is the first backup in the array.

  1. Run the Start-VBREntraIDLogsBackupFLRSession cmdlet. Specify the following settings:
  • Set the $logBackups[0] variable as the Backup parameter value.
  • Set the $tenant variable as the Tenant parameter value.
  • Save the result to the $logRestoreSession variable.
  1. Run the Get-VBRUnstructuredServer cmdlet. Specify the Name parameter value. Save the result to the $fileshare variable.
  2. Run the Get-VBREntraIDLogsBackupFLRItem cmdlet. Specify the following settings:
  • Set the $logRestoreSession variable as the Session parameter value.
  • Specify the Name parameter value.
  • Specify the Recurse parameter value.
  • Save the result to the $files variable.
  1. Run the Save-VBREntraIDLogsBackupFLRItem 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.

Related Commands

Page updated 11/13/2024

Page content applies to build 12.3.0.310