Add-VBREntraIDLogsBackupJob

Short Description

Creates a Microsoft Entra ID log backup job.

Applies to

Product Edition: Enterprise Plus, Veeam Universal License

Syntax

Add-VBREntraIDLogsBackupJob -Tenant <VBREntraIDTenant> [-ShortTermRetentionType <VBREntraIdLogsBackupShortTermRetentionType>] [-ShortTermRetentionPeriod <Int32>] [-TargetBackup <VBREntraIdLogsBackup>] [-Name <String>] [-Description <String>] -ShortTermBackupRepository <CBackupRepository> [-SecondaryTarget <VBRUnstructuredBackupSecondaryTarget[]>] [-StorageOptions <VBRStorageOptions>] [-HealthCheckOptions <VBRFullBackupOptions>] [-NotificationOptions <VBRNotificationOptions>] [-ScriptOptions <VBRJobScriptOptions>] [-ScheduleOptions <VBRServerScheduleOptions>] [-Force] [-HighPriority] [<CommonParameters>]

Detailed Description

This cmdlet creates a backup job for Entra ID audit and sign-in logs.

Parameters

Parameter	Description	Type	Required	Position	Accept Pipeline Input
Tenant	Specifies the tenant whose logs you want to back up.	Accepts the VBREntraIDTenant object. To get this object, run the Get-VBREntraIDTenant cmdlet.	True	Named	False
ShortTermBackupRepository	Specifies the primary backup repository. The cmdlet will use this repository as a primary storage for storing log backups.	Accepts the CBackupRepository object. To get this object, run the Get-VBRBackupRepository cmdlet.	True	Named	False
ShortTermRetentionType	Specifies the type of the retention policy for the primary backup repository. Use the ShortTermRetentionPeriod to specify the number of days, months or years.	VBREntraIdLogsBackupShortTermRetentionType	False	Named	False
ShortTermRetentionPeriod	For the ShortTermRetentionType option. Specifies the period of time to keep data in the primary backup repository.	Int32	False	Named	False
TargetBackup	Used for mapping backups. Specifies an Entra ID log backup. The cmdlet will use data of this backup to create a backup chain instead of creating the chain anew. Note: The backup must be stored in the same repository as specified in ShortTermBackupRepository.	Accepts the VBREntraIdLogsBackup object. To get this object, run the Get-VBREntraIDLogsBackup cmdlet.	False	Named	False
Name	Specifies the name of the log backup job.	String	False	Named	False
Description	Specifies the description of the log backup job.	String	False	Named	False
SecondaryTarget	Specifies the secondary backup repository. The cmdlet will use this repository as the secondary repository for the log backup job.	Accepts the VBRUnstructuredBackupSecondaryTarget[] object. To create this object, run the New-VBRUnstructuredBackupSecondaryTarget cmdlet.	False	Named	False
StorageOptions	Specifies storage optimization settings. The cmdlet will create the log backup job with these settings.	Accepts the VBRStorageOptions object. To create this object, run the New-VBRStorageOptions cmdlet.	False	Named	False
HealthCheckOptions	Specifies the healthcheck schedule. The cmdlet will create the log job with this healthcheck schedule.	Accepts the VBRFullBackupOptions object. To create this object, run the New-VBRFullBackupOptions cmdlet.	False	Named	False
NotificationOptions	Specifies notification options. The cmdlet will create the log backup job with these notification options.	Accepts the VBRNotificationOptions object. To create this object, run the New-VBRNotificationOptions cmdlet.	False	Named	False
ScriptOptions	Specifies pre-job and post-job script options. The cmdlet will create the log backup job with these script options.	Accepts the VBRJobScriptOptions object. To create this object, run the New-VBRJobScriptOptions cmdlet.	False	Named	False
ScheduleOptions	Specifies schedule options. The cmdlet will create the log backup job with these schedule options.	Accepts the VBRServerScheduleOptions object. To create this object, run the New-VBRServerScheduleOptions cmdlet.	False	Named	False
Force	Defines that the cmdlet will create a log backup job without showing warnings or errors in the PowerShell console.	SwichParameter	False	Named	False
HighPriority	Defines that Veeam Backup & Replication will prioritize this job higher than other similar jobs and will allocate resources to it in the first place.	SwichParameter	False	Named	False

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

Output Object

The cmdlet returns the VBREntraIdLogsBackupJob object that contains settings of the Entra ID log backup job.

Examples

This example shows how to add an Entra ID log backup job with the 14 day retention period. The backups will also be copied to a secondary repository. From the secondary repository, the backups will be deleted after 2 months.

$tenant = Get-VBREntraIdTenant -AzureTenantId "xxxx"

$shortRepo = Get-VBRBackupRepository -Name "Default Backup Repository"

$repository = Get-VBRBackupRepository -Name "Secondary Backup Repository"

$secondaryRepo = New-VBRUnstructuredBackupSecondaryTarget -BackupRepository $repository -CustomRetentionType Monthly -CustomRetentionPeriod 2

$logBackupJob = Add-VBREntraIDLogsBackupJob -Tenant $tenant -ShortTermRetentionType 0 -ShortTermRetentionPeriod 14 -Name "Log Backup" -ShortTermBackupRepository $shortRepo -SecondaryTarget $secondaryRepo

Perform the following steps:

Run the Get-VBREntraIdTenant cmdlet. Specify the AzureTenantId parameter value. Save the result to the $tenant variable.
Run the Get-VBRBackupRepository cmdlet. Specify the Name parameter value. Save the result to the $shortRepo variable.
Run the Get-VBRBackupRepository cmdlet. Specify the Name parameter value. Save the result to the $repository variable.
Run the New-VBRUnstructuredBackupSecondaryTarget cmdlet. Specify the following settings:

Set the $repository variable as the BackupRepository parameter value.

Specify the CustomRetentionType and CustomRetentionPeriod parameter values.

Save the result to the $secondaryRepo variable.

Run the Add-VBREntraIDLogsBackupJob cmdlet. Specify the following settings:

Set the $tenant variable as the Tenant parameter value.
Specify the ShortTermRetentionType and ShortTermRetentionPeriod parameter values.
Specify the Name parameter value.
Set the $shortRepo variable as the ShortTermBackupRepository parameter value.
Set the $secondaryRepo variable as the SecondaryTarget parameter value.
Save the result to the $logBackupJob variable.

Related Commands