---
title: "New-VBRTapeMediaPoolRetentionPolicy"
description: "This cmdlet creates the VBRTapeMediaPoolRetentionPolicy object. This object contains the retention settings of media pool. Retention policy sets overwrite protection rules."
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/new-vbrtapemediapoolretentionpolicy.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Tape Devices > Tape Media Pools > New-VBRTapeMediaPoolRetentionPolicy"
dateModified: "2026-08-19"
---

# New-VBRTapeMediaPoolRetentionPolicy

## Short Description
Defines retention settings of a media pool.

**Product Edition**: Standard, Enterprise, Enterprise Plus, Veeam Universal License

## Syntax
```
New-VBRTapeMediaPoolRetentionPolicy [-Period <VBRTapeMediaPoolPeriod>] [-Type <VBRTapeMediaPoolRetentionType>]
 [-Value <Int32>] [<CommonParameters>]
```

## Detailed Description
This cmdlet creates the [`VBRTapeMediaPoolRetentionPolicy`](vbrtapemediapoolretentionpolicy.md) object. This object contains the retention settings of media pool.

Retention policy sets overwrite protection rules. The rules are set to media pool and are applied to all tapes belonging to this media pool. After the retention period ends, the tape is queued for overwriting.

## 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">Period</span></p>
        </td>
        <td>
          <p>Specifies the data retention period. Use this parameter to indicate the time period for the <code>Type</code> parameter:</p><ul><li><code>None</code>: data is not protected. Tapes are overwritten according to the tape rotation settings.</li><li><code>Days</code>: indicates that the data retention period is measured in days. Use the Value parameter to indicate the number of days to protect the data.</li><li><code>Weeks</code>: indicates that the data retention period is measured in  weeks. Use the Value parameter to indicate the number of weeks to protect the data.</li><li><code>Months</code>: indicates that the data retention period is measured in months. Use the Value parameter to indicate the number of months to protect the data.</li></ul>
        </td>
        <td style="width:10%;">
          <p><code>VBRTapeMediaPoolPeriod</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">Type</span></p>
        </td>
        <td>
          <p>Specifies the data retention type:</p><ul><li><code>Never</code>: the data is never overwritten. This option sets a lifelong protection for tapes.</li><li><code>Period</code>: the data is protected for an indicated period. Use the Period and the Value parameters to indicate the period settings.</li><li><code>Cyclic</code>: the data is not protected. The tapes are overwritten according to the tape rotation settings.</li></ul>
        </td>
        <td style="width:10%;">
          <p><code>VBRTapeMediaPoolRetentionType</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">Value</span></p>
        </td>
        <td>
          <p>Sets the number of days, weeks or month to protect the data. You can enter value between 1 and 999. Use this parameter to indicate the value if you set the <code>Period</code> parameter to <code>Days</code>, <code>Weeks</code> or <code>Months</code>.</p>
        </td>
        <td style="width:10%;">
          <p><code>Int32</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>
    </table>

`<CommonParameters>`

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see [ Microsoft Docs](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_commonparameters?view=powershell-7).

## Output Object
[`VBRTapeMediaPoolRetentionPolicy`](vbrtapemediapoolretentionpolicy.md)

## Examples

::: example
### Example 1. Creating Retention Period Rule for Media Pool

This command defines media pool retention rules and saves the result to the `$newretention` variable. The retention rules contain the following settings:

- The retention period is set to 14 days.
- The `Type` is set to `Period`, the `Period` is set to `Days`, and the `Value` is set to `14`.

```
$newretention = New-VBRTapeMediaPoolRetentionPolicy -Type Period -Period Days -Value 14
```

:::

::: example
### Example 2. Switching Off Data Retention for Media Pool

This command defines media pool retention rules and saves the result to the `$noretention` variable. The `Type` is set to `Cyclic`.

```
$noretention = New-VBRTapeMediaPoolRetentionPolicy -Type Cyclic
```

:::