---
title: "Add-VBOOrganizationRetentionExclusion"
description: "This cmdlet adds retention policy settings for contacts and calendars of a specific organization. This retention policy has higher priority than the global retention policy."
canonical: "https://helpcenter.veeam.com/docs/vbo365/powershell/add-vboorganizationretentionexclusion.html"
breadcrumb: "PowerShell Reference > Veeam Backup for Microsoft 365 PowerShell Reference > Organizations Management > Organization Objects > Add-VBOOrganizationRetentionExclusion"
dateModified: "2026-08-21"
---

# Add-VBOOrganizationRetentionExclusion

## Short Description
Adds retention policy settings for contacts and calendars of a specific organization.

## Syntax
```
Add-VBOOrganizationRetentionExclusion -Organization <VBOOrganization> [-Contacts] [-Calendar] [<CommonParameters>]
```

## Detailed Description
This cmdlet adds retention policy settings for contacts and calendars of a specific organization.

::: important

This retention policy has higher priority than the global retention policy.

:::

## 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">Calendar</span></p>
        </td>
        <td>
          <p>Defines that Veeam Backup for Microsoft 365 will not apply retention policy for calendars of the specified organization.</p><p>If you do not provide this parameter, Veeam Backup for Microsoft 365 will apply retention policy for calendars.</p><p>Default: <em>False</em></p>
        </td>
        <td style="width:10%;">
          <p><code>SwitchParameter</code></p>
        </td>
        <td style="width:10%;">
          <p>False</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">Contacts</span></p>
        </td>
        <td>
          <p>Defines that Veeam Backup for Microsoft 365 will not apply retention policy for contacts of the specified organization.</p><p>If you do not provide this parameter, Veeam Backup for Microsoft 365 will apply retention policy for contacts.</p><p>Default: <em>False</em></p>
        </td>
        <td style="width:10%;">
          <p><code>SwitchParameter</code></p>
        </td>
        <td style="width:10%;">
          <p>False</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">Organization</span></p>
        </td>
        <td>
          <p>Specifies a Microsoft organization. The cmdlet will set retention policy for contacts and calendars added to the specified organization.</p><p>Accepts the <a href="vboorganization.md"><code>VBOOrganization</code></a> object.</p><p>To get this object, run the <a href="get-vboorganization.md"><code>Get-VBOOrganization</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vboorganization.md"><code>VBOOrganization</code></a></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
This cmdlet returns the [`VBOOrganizationRetentionExclusion`](vboorganizationretentionexclusion.md) object that contains settings of organization retention policy for contacts and calendars.

## Examples

::: example
### Example 1: Enabling Retention Policy for Organization Contacts

This example shows how to enable retention policy for contacts of the `Atlanta` organization. Veeam Backup for Microsoft 365 will apply retention policy for contacts added to the `Atlanta` organization.

```
$org = Get-VBOOrganization -Name "Atlanta"
Add-VBOOrganizationRetentionExclusion -Organization $org -Contacts
```

Perform the following steps:

1. Run the [`Get-VBOOrganization`](get-vboorganization.md) cmdlet. Set the `Name` parameter value. Save the result to the `$org` variable.
2. Run the `Add-VBOOrganizationRetentionExclusion` cmdlet. Set the `$org` variable as the `Organization` parameter value. Provide the `Contacts` parameter.

:::

::: example
### Example 2: Enabling Retention Policy for Organization Calendars

This example shows how to enable retention policy for calendars of the `Atlanta` organization. Veeam Backup for Microsoft 365 will apply retention policy for calendars added to the `Atlanta` organization.

```
$org = Get-VBOOrganization -Name "Atlanta"
Add-VBOOrganizationRetentionExclusion -Organization $org -Calendar
```

Perform the following steps:

1. Run the [`Get-VBOOrganization`](get-vboorganization.md) cmdlet. Set the `Name` parameter value. Save the result to the `$org` variable.
2. Run the `Add-VBOOrganizationRetentionExclusion` cmdlet. Set the `$org` variable as the `Organization` parameter value. Provide the `Calendar` parameter.

:::

## Related Commands

[`Get-VBOOrganization`](get-vboorganization.md)