---
title: "Start-VBREntraIDLogsBackupFLRSession"
description: "Starts a restore session to explore log files and folders that a log backup contains. Product Edition: Enterprise Plus, Veeam Universal License This cmdlet starts a log restore session."
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/start-vbrentraidlogsbackupflrsession.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Microsoft EntraID Support > Log Data Recovery > Start-VBREntraIDLogsBackupFLRSession"
dateModified: "2026-08-20"
---

# Start-VBREntraIDLogsBackupFLRSession

## Short Description
Starts a restore session to explore log files and folders that a log backup contains.

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

## Syntax
```
Start-VBREntraIDLogsBackupFLRSession -Tenant <VBREntraIDTenant> -Backup <VBRUnstructuredBackup>
 [-RetrievalSettings <VBRUnstructuredBackupColdStorageRetrievalSettings>] [-Force] [<CommonParameters>]
```

## Detailed Description
This cmdlet starts a log restore session. During this session, the cmdlet gets access to the log files and folders in the Entra ID log backup.

After you gain the access, you can use this session to restore specific files and folders stored in the log backup. For this, launch the following cmdlets:

- [`Get-VBREntraIDLogsBackupFLRItem`](get-vbrentraidlogsbackupflritem.md) to get the backed-up files and folders.
- [`Save-VBREntraIDLogsBackupFLRItem`](save-vbrentraidlogsbackupflritem.md) to save the backed-up files and folders.

## Parameters

<table style="width:100%;" class="Blue_Table">
      <tr style="vertical-align:top">
        <th style="width:20%;">
          <p>Parameter</p>
        </th>
        <th style="width:20%;">
          <p>Description</p>
        </th>
        <th style="width:20%;">
          <p>Type</p>
        </th>
        <th style="width:10%;">
          <p>Required</p>
        </th>
        <th style="width:10%;">
          <p>Position</p>
        </th>
        <th style="width:10%;">
          <p>Accept Pipeline Input</p>
        </th>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Backup</span></p>
        </td>
        <td>
          <p>Specifies the backup from which you want to get access to logs. You can further restore files from this backup.</p><p>Accepts the <code>VBREntraIdLogsBackup</code> object. To get this object, run the <a href="get-vbrentraidlogsbackup.md"><code>Get-VBREntraIDLogsBackup</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbrunstructuredbackup.md"><code>VBRUnstructuredBackup</code></a></p>
        </td>
        <td style="width:10%;">
          <p>True</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>True (ByPropertyName, ByValue)</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Force</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will modify settings of managed file shares without showing warnings in the PowerShell console.</p>
        </td>
        <td style="width:10%;">
          <p><code>SwitchParameter</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">RetrievalSettings</span></p>
        </td>
        <td>
          <p>Specifies the retrieval policy settings. The cmdlet will use these settings to retrieve data from archive repositories.</p><p>Accepts the <code>VBRUnstructuredBackupColdStorageRetrievalSettings</code> object. To create this object, run the <a href="new-vbrunstructuredbackupretrievalsettings.md"><code>New-VBRUnstructuredBackupColdStorageRetrievalSettings</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>VBRUnstructuredBackupColdStorageRetrievalSettings</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Tenant</span></p>
        </td>
        <td>
          <p>Specifies the tenant whose logs you want to access.</p><p>Accepts the <code>VBREntraIDTenant</code> object. To get this object, run the <a href="get-vbrentraidtenant.md"><code>Get-VBREntraIDTenant</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbrentraidtenant.md"><code>VBREntraIDTenant</code></a></p>
        </td>
        <td style="width:10%;">
          <p>True</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>True (ByPropertyName)</p>
        </td>
      </tr>
    </table>

`<CommonParameters>`

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see [ Microsoft Docs](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_commonparameters?view=powershell-7).

## Output Object
The cmdlet returns the `VBRUnstructuredBackupFLRSession` object that contains properties of the log restore session.

## Examples

::: example
### Starting Log Restore Session

This example shows how to start a log restore session.

```
$tenant = Get-VBREntraIdTenant -AzureTenantId "xxxxx"
$logBackups = Get-VBREntraIDLogsBackup
$logRestoreSession = Start-VBREntraIDLogsBackupFLRSession -Backup $logBackups[0] -Tenant $tenant
```

Perform the following steps:

1. Run the [`Get-VBREntraIdTenant`](get-vbrentraidtenant.md) cmdlet. Specify the `AzureTenantId` parameter value. Save the result to the `$tenant` variable.
2. Run the [`Get-VBREntraIDLogsBackup`](get-vbrentraidlogsbackup.md) cmdlet.

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

3. 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.

:::

## Related Commands

- [`Get-VBREntraIdTenant`](get-vbrentraidtenant.md)
- [`Get-VBREntraIDLogsBackup`](get-vbrentraidlogsbackup.md)
- [`New-VBRUnstructuredBackupColdStorageRetrievalSettings`](new-vbrunstructuredbackupretrievalsettings.md)