Start-VBREntraIDLogsBackupFLRSession
Short Description
Starts a restore session to explore log files and folders that a log backup contains.
Applies to
Product Edition: Enterprise Plus, Veeam Universal License
Syntax
|
Start-VBREntraIDLogsBackupFLRSession -Backup <VBREntraIdLogsBackup> -Tenant <VBREntraIDTenant> [<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 to get the backed-up files and folders.
- Save-VBREntraIDLogsBackupFLRItem to save the backed-up files and folders.
Parameters
|
Parameter |
Description |
Type |
Required |
Position |
Accept |
|---|---|---|---|---|---|
|
Backup |
Specifies the backup from which you want to get access to logs. You can further restore files from this backup. |
Accepts the VBREntraIdLogsBackup object. To get this object, run the Get-VBREntraIDLogsBackup cmdlet. |
True |
Named |
True (ByPropertyName, ByValue) |
|
Tenant |
Specifies the tenant whose logs you want to access. |
Accepts the VBREntraIDTenant object. To get this object, run the Get-VBREntraIDTenant cmdlet. |
True |
Named |
True (ByPropertyName) |
|
RetrievalSettings |
Specifies the retrieval policy settings. The cmdlet will use these settings to retrieve data from archive repositories. |
Accepts the VBRUnstructuredBackupColdStorageRetrievalSettings object. To create this object, run the New-VBRUnstructuredBackupColdStorageRetrievalSettings cmdlet. |
False |
Named |
False |
|
Force |
Defines that the cmdlet will modify settings of managed file shares without showing warnings in the PowerShell console. |
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 VBRUnstructuredBackupFLRSession object that contains properties of the log restore session.
Examples
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:
- Run the Get-VBREntraIdTenant cmdlet. Specify the AzureTenantId parameter value. Save the result to the $tenant variable.
- Run the Get-VBREntraIDLogsBackup 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.
- 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