---
title: "Set-VBOHistorySettings"
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."
canonical: "https://helpcenter.veeam.com/docs/vbo365/powershell/set-vbohistorysettings.html"
breadcrumb: "PowerShell Reference > Veeam Backup for Microsoft 365 PowerShell Reference > Job Session History Settings > Set-VBOHistorySettings"
dateModified: "2026-08-21"
---

# Set-VBOHistorySettings

## Short Description
Modifies history settings for backup and backup copy job sessions.

## Syntax

This cmdlet provides the following parameter sets:

<ul class="syntax-sets">
  <li>
    <p><code>KeepOnlyLastXweeks (Default)</code></p>

```
Set-VBOHistorySettings -KeepOnlyLastXweeks <Int32> [<CommonParameters>]
```
  </li>
  <li>
    <p><code>KeepAllSessions</code></p>

```
Set-VBOHistorySettings [-KeepAllSessions] [<CommonParameters>]
```
  </li>
</ul>

## 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

<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">KeepAllSessions</span></p>
        </td>
        <td>
          <p>Defines that Veeam Backup for Microsoft 365 will keep job sessions forever.</p><p>Default: <em>False</em></p>
        </td>
        <td style="width:10%;">
          <p><code>SwitchParameter</code></p>
        </td>
        <td style="width:10%;">
          <p>True</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">KeepOnlyLastXweeks</span></p>
        </td>
        <td>
          <p>Specifies the retention period for job sessions (weeks).</p><p>Default: <em>53</em></p>
        </td>
        <td style="width:10%;">
          <p><code>Int32</code></p>
        </td>
        <td style="width:10%;">
          <p>True</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
    </table>

`<CommonParameters>`

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see the [About Common Parameters](http://go.microsoft.com/fwlink/p/?LinkID=113216) section of Microsoft Learn.

## Output Object
The cmdlet returns the [`VBOHistorySettings`](vbohistorysettings.md) object that contains history settings for backup and backup copy job sessions.

## Examples

::: example
### Example 1: Setting Job Session Retention Period

This command sets job session retention period in weeks.

```
Set-VBOHistorySettings -KeepOnlyLastXweeks 1
```

:::

::: example
### Example 2: Keeping Job Sessions Forever

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

```
Set-VBOHistorySettings -KeepAllSessions
```

:::