Set-VBOHistorySettings

Short Description

Modifies history settings for backup and backup copy job sessions.

Syntax

This cmdlet provides parameter sets that allow you to:

  • Modify session history settings in weeks.

Set-VBOHistorySettings -KeepOnlyLastXweeks <Int32>  [<CommonParameters>]

  • Modify session history settings to keep job sessions in Veeam Backup for Microsoft 365 forever.

Set-VBOHistorySettings -KeepAllSessions <SwitchParameter> [<CommonParameters>]

Detailed Description

This cmdlet modifies the job session history settings. By default, Veeam Backup for Microsoft 365 will keep job sessions forever.

To modify settings, you need to enter the necessary parameters with new values. The parameters that you omit will remain unchanged.

Parameters

Parameter

Description

Type

Required

Position

Accept Pipeline Input

Accept Wildcard Characters

KeepOnlyLastXweeks

Specifies the retention period for job sessions (weeks).

Default: 53

Int32

True

Named

False

False

KeepAllSessions

Defines that Veeam Backup for Microsoft 365 will keep job sessions forever.

SwitchParameter

True

Named

False

False

<CommonParameters>

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see the About CommonParameters section of Microsoft Docs.

Examples

Set-VBOHistorySettingsExample 1. Setting Job Session Retention Period

This command sets job session retention period in weeks.

Set-VBOHistorySettings -KeepOnlyLastXweeks 1

Set-VBOHistorySettingsExample 2. Keeping Job Sessions Forever

This command configures Veeam Backup for Microsoft 365 to keep job sessions forever.

Set-VBOHistorySettings -KeepAllSessions