Get-VBREntraIDLogsBackupFLRItem
Returns backed-up objects created by a log backup job.
Product Edition: Enterprise Plus, Veeam Universal License
Get-VBREntraIdLogsBackupFLRItem -Session <VBRUnstructuredBackupFLRSession> [-Name <String>] [-Folder <VBRUnstructuredBackupFLRFolder>] [-Recurse] [<CommonParameters>] |
This cmdlet returns an array of backed-up objects created by a log backup job. These objects contain settings of log files and folders backed up by a log backup job.
Parameter | Description | Type | Required | Position | Accept
Pipeline
Input |
|---|
Session | Specifies a restore session. The cmdlet will return backed-up objects within this restore session. | Accepts the VBRUnstructuredBackupFLRSession object. To create this object, run the Start-VBREntraIDLogsBackupFLRSession cmdlet. | True | Named | True (ByPropertyName, ByValue) |
Name | Specifies a name of the backed-up object. The cmdlet will return folders and files with the specified name. Note: By default, the cmdlet returns up to 10,000 records (folders and files). You can change the default value with a registry key. For more information, contact Veeam Customer Support. | String | False | Named | False |
Folder | Specifies a backed-up folder. The cmdlet will return objects that are added to this folder. | Accepts the VBRUnstructuredBackupFLRFolder object. To get this object, run the Get-VBREntraIDLogsBackupFLRItem cmdlet. | False | Named | False |
Recurse | Defines that the cmdlet will look for objects that are added to backed-up child folders. If you provide this parameter, the cmdlet will return an array of all objects that are added to backed-up child folders. Otherwise, the cmdlet will return an array of objects that are added to the parent folder. | SwitchParameter | False | Named | False |
<CommonParameters>
This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see Microsoft Docs.
The cmdlet returns the array of VBRUnstructuredBackupFLRItem objects that contain settings of log files and folders backed up by the log backup job.
This example shows how to get first-level log folders. $tenant = Get-VBREntraIdTenant -AzureTenantId "xxxxx" $logBackups = Get-VBREntraIDLogsBackup $logRestoreSession = Start-VBREntraIDLogsBackupFLRSession -Backup $logBackups[0] -Tenant $tenant $folders = Get-VBREntraIDLogsBackupFLRItem -Session $logRestoreSession |
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. 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.
- Run the Get-VBREntraIDLogsBackupFLRItem cmdlet. Set the $logRestoreSession variable as the Session parameter value. Save the result to the $folders variable.
|
This example shows how to get all backed-up log files and folders. $tenant = Get-VBREntraIdTenant -AzureTenantId "xxxxx" $logBackups = Get-VBREntraIDLogsBackup $logRestoreSession = Start-VBREntraIDLogsBackupFLRSession -Backup $logBackups[0] -Tenant $tenant $filesFolders = Get-VBREntraIDLogsBackupFLRItem -Session $logRestoreSession -Recurse |
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. 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.
- Run the Get-VBREntraIDLogsBackupFLRItem cmdlet. Specify the following settings:
- Set the $logRestoreSession variable as the Session parameter value.
- Provide the Recurse parameter.
- Save the result to the $filesFolders variable.
|
This example shows how to get audit and sign-in log files whose names start with 2024-11-01T10. $tenant = Get-VBREntraIdTenant -AzureTenantId "xxxxx" $logBackups = Get-VBREntraIDLogsBackup $logRestoreSession = Start-VBREntraIDLogsBackupFLRSession -Backup $logBackups[0] -Tenant $tenant $files = Get-VBREntraIDLogsBackupFLRItem -Session $logRestoreSession -Name "2024-11-01T10*" -Recurse |
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. 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.
- Run the Get-VBREntraIDLogsBackupFLRItem cmdlet. Specify the following settings:
- Set the $logRestoreSession variable as the Session parameter value.
- Specify the Name parameter value.
- Provide the Recurse parameter value.
- Save the result to the $files variable.
|
This example shows how to get all files that are located in the the Audit Logs folder. The Audit Logs folder is located in the November 2024 folder. $tenant = Get-VBREntraIdTenant -AzureTenantId "xxxxx" $logBackups = Get-VBREntraIDLogsBackup $logRestoreSession = Start-VBREntraIDLogsBackupFLRSession -Backup $logBackups[0] -Tenant $tenant $novemberFolder = Get-VBREntraIDLogsBackupFLRItem -Session $logRestoreSession -Name "November 2024" $auditLogsFolder = Get-VBREntraIDLogsBackupFLRItem -Session $logRestoreSession -Folder $novemberFolder -Name "Audit Logs" $novAuditLogs = Get-VBREntraIDLogsBackupFLRItem -Session $logRestoreSession -Folder $auditLogsFolder |
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. 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.
- Run the Get-VBREntraIDLogsBackupFLRItem cmdlet. Set the $logRestoreSession variable as the Session parameter value. Specify the Name parameter value. Save the result to the $novemberFolder variable.
- Run the Get-VBREntraIDLogsBackupFLRItem cmdlet. Specify the following settings:
- Set the $logRestoreSession variable as the Session parameter value.
- Set the $novemberFolder variable as the Folder parameter value.
- Specify the Name parameter value.
- Save the result to the $auditLogsFolder variable.
- Run the Get-VBREntraIDLogsBackupFLRItem cmdlet. Specify the following settings:
- Set the $logRestoreSession variable as the Session parameter value.
- Set the $auditLogsFolder variable as the Folder parameter value.
- Save the result to the $novAuditLogs variable.
|
Related Commands
Example 1. Getting First-Level Log Folders