---
title: "New-VBRUnstructuredBackupRetrievalSettings"
description: "Defines retrieval policy settings for archive object storage repositories. Product Edition: Standard, Enterprise, Enterprise Plus, Veeam Universal License This cmdlet provides the following parameter sets: This cmdlet defines retrieval policy setting"
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/new-vbrunstructuredbackupretrievalsettings.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Unstructured Data Backup > Managing Unstructured Data Backups > New-VBRUnstructuredBackupRetrievalSettings"
dateModified: "2026-08-19"
---

# New-VBRUnstructuredBackupRetrievalSettings

## Short Description
Defines retrieval policy settings for archive object storage repositories.

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

## Syntax

This cmdlet provides the following parameter sets:

<ul class="syntax-sets">
  <li>
    <p><code>AmazonGlacierStorage</code></p>

```
New-VBRUnstructuredBackupRetrievalSettings [-AvailabilityPeriodDays <UInt32>] [-EnableExpirationNotification]
 -AmazonS3GlacierRetrievalPolicy <VBRAmazonS3GlacierRetrievalPolicy> [-ExpirationHoursThreshold <UInt32>] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>AzureArchiveStorage</code></p>

```
New-VBRUnstructuredBackupRetrievalSettings [-AvailabilityPeriodDays <UInt32>] [-EnableExpirationNotification]
 -AzureArchiveRetrievalPolicy <VBRAzureArchiveRetrievalPolicy> [-ExpirationHoursThreshold <UInt32>] [<CommonParameters>]
```
  </li>
</ul>

## Detailed Description
This cmdlet defines retrieval policy settings for archive object storage repositories that are used as targets for unstructured data backup jobs.

## 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">AmazonS3GlacierRetrievalPolicy</span></p>
        </td>
        <td>
          <p>Defines the method of data retrieval for Amazon S3 Glacier object storage. You can retrieve data using one of the following methods:</p><ul><li><code>Expedited</code></li><li><code>StandardAccelerated</code></li><li><code>Standard</code></li><li><code>Bulk</code></li></ul>
        </td>
        <td style="width:10%;">
          <p><code>VBRAmazonS3GlacierRetrievalPolicy</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">AvailabilityPeriodDays</span></p>
        </td>
        <td>
          <p>Specifies a period in days during which the retrieved archive backup files will be available.</p>
        </td>
        <td style="width:10%;">
          <p><code>UInt32</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">AzureArchiveRetrievalPolicy</span></p>
        </td>
        <td>
          <p>Defines the method of data retrieval for Azure Archive storage. You can retrieve data using one of the following methods:</p><ul><li><code>StandardPriority</code></li><li><code>HighPriority</code></li></ul>
        </td>
        <td style="width:10%;">
          <p><code>VBRAzureArchiveRetrievalPolicy</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">EnableExpirationNotification</span></p>
        </td>
        <td>
          <p>Defines that Veeam Backup & Replication will send the notification about the upcoming expiration of retrieved archive backup files.</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">ExpirationHoursThreshold</span></p>
        </td>
        <td>
          <p>Specifies the threshold in hours for sending the notification about the upcoming expiration of retrieved archive backup files.</p><p><strong>Note</strong>: This parameter is required if you specify the <code>EnableExpirationNotification</code> parameter.</p>
        </td>
        <td style="width:10%;">
          <p><code>UInt32</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
The cmdlet returns the `VBRUnstructuredBackupRetrievalSettings` object that contains retrieval policy settings for archive object storage repositories.

## Examples

::: example
### Example 1. Defining Retrieval Policy Settings for Microsoft Azure Archive Repository

This example shows how to define retrieval policy settings for a Microsoft Azure archive repository.

```
New-VBRUnstructuredBackupRetrievalSettings -AzureArchiveRetrievalPolicy HighPriority -AvailabilityPeriodDays 7 -EnableExpirationNotification -ExpirationHoursThreshold 24
```

:::

::: example
### Example 2. Defining Retrieval Policy Settings for Amazon S3 Glacier Archive Repository

This example shows how to define retrieval policy settings for a Amazon S3 Glacier archive repository.

```
New-VBRUnstructuredBackupRetrievalSettings -AmazonS3GlacierRetrievalPolicy HighPriority -AvailabilityPeriodDays 7 -EnableExpirationNotification -ExpirationHoursThreshold 24
```

:::