---
title: "Add-VBOAmazonS3GlacierRepository"
description: "This cmdlet adds a backup repository of the Amazon S3 object storage type, in particular — Amazon S3 Glacier Instant Retrieval, Amazon S3 Glacier Flexible Retrieval and Amazon S3 Glacier Deep Archive storage classes, to the Veeam Backup for..."
canonical: "https://helpcenter.veeam.com/docs/vbo365/powershell/add-vboamazons3glacierrepository.html"
breadcrumb: "PowerShell Reference > Veeam Backup for Microsoft 365 PowerShell Reference > Backup Infrastructure > JET-based Backup Repositories and Object Storage Repositories > Add-VBOAmazonS3GlacierRepository"
dateModified: "2026-08-21"
---

# Add-VBOAmazonS3GlacierRepository

## Short Description
Adds Amazon S3 object storage repository (Amazon S3 Glacier Instant Retrieval, Amazon S3 Glacier Flexible Retrieval and Amazon S3 Glacier Deep Archive storage classes) to the Veeam Backup for Microsoft 365 infrastructure.

## Syntax

This cmdlet provides the following parameter sets:

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

```
Add-VBOAmazonS3GlacierRepository [-EnableGlacierDeepArchive] [-EnableGlacierInstantRetrieval]
 [-IgnoreProxyPoolApplianceAccessValidation] -ObjectStorageSettings <VBOAmazonS3ObjectStorageRepository>
 [-ObjectStorageEncryptionKey <IVBOCredentialKey>] [-SyncNow] [-SizeLimit <UInt64>] [-EnableImmutability]
 [-EnableImmutabilityGovernanceMode] [-Proxy <VBOProxy>] [-ProxyPool <VBOProxyPool>] -Name <String>
 [-Description <String>] [-RetentionType <VBORetentionType>] [-Force] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>DailyParameterSet</code></p>

```
Add-VBOAmazonS3GlacierRepository [-EnableGlacierDeepArchive] [-EnableGlacierInstantRetrieval]
 [-IgnoreProxyPoolApplianceAccessValidation] -ObjectStorageSettings <VBOAmazonS3ObjectStorageRepository>
 -RetentionPeriod <VBORetentionPeriod> -RetentionFrequencyType <VBORetentionFrequencyType>
 -DailyTime <TimeSpan> -DailyType <VBODailyType> [-ObjectStorageEncryptionKey <IVBOCredentialKey>] [-SyncNow]
 [-SizeLimit <UInt64>] [-EnableImmutability] [-EnableImmutabilityGovernanceMode] [-Proxy <VBOProxy>]
 [-ProxyPool <VBOProxyPool>] -Name <String> [-Description <String>] [-RetentionType <VBORetentionType>]
 [-Force] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>MonthlyParameterSet</code></p>

```
Add-VBOAmazonS3GlacierRepository [-EnableGlacierDeepArchive] [-EnableGlacierInstantRetrieval]
 [-IgnoreProxyPoolApplianceAccessValidation] -ObjectStorageSettings <VBOAmazonS3ObjectStorageRepository>
 -RetentionPeriod <VBORetentionPeriod> -RetentionFrequencyType <VBORetentionFrequencyType>
 -MonthlyTime <TimeSpan> -MonthlyDayNumber <VBOMonthlyDayNumber> -MonthlyDayOfWeek <DayOfWeek>
 [-ObjectStorageEncryptionKey <IVBOCredentialKey>] [-SyncNow] [-SizeLimit <UInt64>] [-EnableImmutability]
 [-EnableImmutabilityGovernanceMode] [-Proxy <VBOProxy>] [-ProxyPool <VBOProxyPool>] -Name <String>
 [-Description <String>] [-RetentionType <VBORetentionType>] [-Force] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>DailyCustomRetentionParameterSet</code></p>

```
Add-VBOAmazonS3GlacierRepository [-EnableGlacierDeepArchive] [-EnableGlacierInstantRetrieval]
 [-IgnoreProxyPoolApplianceAccessValidation] -ObjectStorageSettings <VBOAmazonS3ObjectStorageRepository>
 -CustomRetentionPeriodType <VBORetentionPeriodType> -CustomRetentionPeriod <Int32>
 -RetentionFrequencyType <VBORetentionFrequencyType> -DailyTime <TimeSpan> -DailyType <VBODailyType>
 [-ObjectStorageEncryptionKey <IVBOCredentialKey>] [-SyncNow] [-SizeLimit <UInt64>] [-EnableImmutability]
 [-EnableImmutabilityGovernanceMode] [-Proxy <VBOProxy>] [-ProxyPool <VBOProxyPool>] -Name <String>
 [-Description <String>] [-RetentionType <VBORetentionType>] [-Force] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>MonthlyCustomRetentionParameterSet</code></p>

```
Add-VBOAmazonS3GlacierRepository [-EnableGlacierDeepArchive] [-EnableGlacierInstantRetrieval]
 [-IgnoreProxyPoolApplianceAccessValidation] -ObjectStorageSettings <VBOAmazonS3ObjectStorageRepository>
 -CustomRetentionPeriodType <VBORetentionPeriodType> -CustomRetentionPeriod <Int32>
 -RetentionFrequencyType <VBORetentionFrequencyType> -MonthlyTime <TimeSpan>
 -MonthlyDayNumber <VBOMonthlyDayNumber> -MonthlyDayOfWeek <DayOfWeek>
 [-ObjectStorageEncryptionKey <IVBOCredentialKey>] [-SyncNow] [-SizeLimit <UInt64>] [-EnableImmutability]
 [-EnableImmutabilityGovernanceMode] [-Proxy <VBOProxy>] [-ProxyPool <VBOProxyPool>] -Name <String>
 [-Description <String>] [-RetentionType <VBORetentionType>] [-Force] [<CommonParameters>]
```
  </li>
</ul>

## Detailed Description
This cmdlet adds a backup repository of the Amazon S3 object storage type, in particular — Amazon S3 Glacier Instant Retrieval, Amazon S3 Glacier Flexible Retrieval and Amazon S3 Glacier Deep Archive storage classes, to the Veeam Backup for Microsoft 365 infrastructure. Veeam Backup for Microsoft 365 uses backup repositories as storage systems for backups and backup copies created for Microsoft 365 and on-premises Microsoft organizations. Every backup repository has the retention policy that defines how long you want to keep backups on a backup repository.

You can specify the following retention policy settings:

- Retention period to specify how long you want to keep data on a backup repository. You can set the period to years, months or days.
- Retention policy schedule to specify the day and time when Veeam Backup for Microsoft 365 must check the backup repository and remove the outdated backups. You can set the schedule to daily or monthly.
- Retention policy type to set it to Item-level or to snapshot-based types.

For more information on retention policy, see the [Retention Policy](https://helpcenter.veeam.com/docs/vbo365/guide/retention_policy.html?ver=8) section of the Veeam Backup for Microsoft 365 User Guide.

## 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">CustomRetentionPeriod</span></p>
        </td>
        <td>
          <p>For the <code>CustomRetentionPeriodType</code> option.</p><p>Specifies the retention period to keep data on the object storage repository. The retention period is defined according to the <code>CustomRetentionPeriod</code> settings:</p><ul><li>Sets the retention period to the number of months if the <code>CustomRetentionPeriodType</code> parameter is set to <code>Months</code>.</li><li>Sets the retention period to the number of days if the <code>CustomRetentionPeriodType</code> parameter is set to <code>Days</code>.</li></ul><p>Veeam Backup for Microsoft 365 will remove items from the object storage repository once this period is passed.</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>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">CustomRetentionPeriodType</span></p>
        </td>
        <td>
          <p>Specifies a type of custom retention period. Veeam Backup for Microsoft 365 will remove items from the object storage repository once this period is passed. You can set the custom retention period to either of the following types:</p><ul><li><code>Months</code></li><li><code>Days</code></li></ul><p>Set the <code>CustomRetentionPeriod</code> parameter to specify the number of days or the number of months.</p>
        </td>
        <td style="width:10%;">
          <p><code>VBORetentionPeriodType</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">DailyTime</span></p>
        </td>
        <td>
          <p>For daily retention policy schedule.</p><p>Specifies the time of the day when Veeam Backup for Microsoft 365 must apply the retention policy.</p><p>Default: <em>00:00:00</em></p>
        </td>
        <td style="width:10%;">
          <p><code>TimeSpan</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">DailyType</span></p>
        </td>
        <td>
          <p>For daily retention policy schedule.</p><p>Specifies the days when Veeam Backup for Microsoft 365 must apply the retention policy:</p><ul><li><code>Sunday</code></li><li><code>Monday</code></li><li><code>Tuesday</code></li><li><code>Wednesday</code></li><li><code>Thursday</code></li><li><code>Friday</code></li><li><code>Saturday</code></li><li><code>Everyday</code></li><li><code>Workdays</code></li><li><code>Weekends</code></li></ul><p>Default: <em>Everyday</em></p>
        </td>
        <td style="width:10%;">
          <p><code>VBODailyType</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">Description</span></p>
        </td>
        <td>
          <p>Specifies a description of Amazon S3 object storage repository. The cmdlet will add an object storage repository with this description.</p><p>The default description contains information on the user who added the object storage repository, date and time when the object storage repository was added.</p>
        </td>
        <td style="width:10%;">
          <p><code>String</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">EnableGlacierDeepArchive</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will enable the Amazon S3 Glacier Deep Archive storage class.</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">EnableGlacierInstantRetrieval</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will enable the Amazon S3 Glacier Instant Retrieval storage class.</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">EnableImmutability</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will add the object storage repository to the Veeam Backup for Microsoft 365 infrastructure with the immutability feature enabled. Veeam Backup for Microsoft 365 allows you to prohibit deletion of data from the object storage repository by making that data temporarily immutable and to protect data against malware activity.</p><p>For more information about the immutability feature, see the <a href="https://helpcenter.veeam.com/docs/vbo365/guide/immutability.html?ver=8">Immutability</a> section of the Veeam Backup for Microsoft 365 User Guide.</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">EnableImmutabilityGovernanceMode</span></p>
        </td>
        <td>
          <p>Defines that a storage administrator with specific permissions to be allowed to override the lock settings and to delete the protected backups in the object storage repository added by the cmdlet.</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">Force</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will add the object storage repository to the Veeam Backup for Microsoft 365 infrastructure without notifying the user.</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">IgnoreProxyPoolApplianceAccessValidation</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will ignore check whether backup proxy servers that belong to the specified backup proxy pool can access the archiver appliance.</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">MonthlyDayNumber</span></p>
        </td>
        <td>
          <p>For monthly retention policy schedule.</p><p>Specifies the order number for the day of the week when Veeam Backup for Microsoft 365 must apply the retention policy.</p><ul><li><code>First</code></li><li><code>Second</code></li><li><code>Third</code></li><li><code>Fourth</code></li><li><code>Last</code></li></ul><p>Default: <em>First</em></p>
        </td>
        <td style="width:10%;">
          <p><code>VBOMonthlyDayNumber</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">MonthlyDayOfWeek</span></p>
        </td>
        <td>
          <p>For monthly retention policy schedule.</p><p>Specifies the day of the week when Veeam Backup for Microsoft 365 must apply the retention policy.</p><ul><li><code>Sunday</code></li><li><code>Monday</code></li><li><code>Tuesday</code></li><li><code>Wednesday</code></li><li><code>Thursday</code></li><li><code>Friday</code></li><li><code>Saturday</code></li></ul><p>Default: <em>Monday</em></p>
        </td>
        <td style="width:10%;">
          <p><code>DayOfWeek</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">MonthlyTime</span></p>
        </td>
        <td>
          <p>For monthly retention policy schedule.</p><p>Specifies the time of the day when Veeam Backup for Microsoft 365 must apply the retention policy.</p><p>Default: <em>18:00:00</em></p>
        </td>
        <td style="width:10%;">
          <p><code>TimeSpan</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">Name</span></p>
        </td>
        <td>
          <p>Specifies a name of Amazon S3 object storage repository. The cmdlet will add an object storage repository with this name.</p>
        </td>
        <td style="width:10%;">
          <p><code>String</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">ObjectStorageEncryptionKey</span></p>
        </td>
        <td>
          <p>Specifies object storage encryption key. Veeam Backup for Microsoft 365 will encrypt data that is saved to this object storage repository.</p><p>Accepts the <a href="vboencryptionkey.md"><code>VBOEncryptionKey</code></a> object.</p><p>To get this object, run the <a href="get-vboencryptionkey.md"><code>Get-VBOEncryptionKey</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>IVBOCredentialKey</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">ObjectStorageSettings</span></p>
        </td>
        <td>
          <p>Specifies the Amazon S3 object storage settings.</p><p>Accepts the <a href="vboamazons3objectstoragerepository.md"><code>VBOAmazonS3ObjectStorageRepository</code></a> object.</p><p>To get this object, run the <a href="new-vboamazons3objectstoragesettings.md"><code>New-VBOAmazonS3ObjectStorageSettings</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vboamazons3objectstoragerepository.md"><code>VBOAmazonS3ObjectStorageRepository</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>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Proxy</span></p>
        </td>
        <td>
          <p>Specifies a backup proxy server. The cmdlet will map a new Amazon S3 object storage repository to this backup proxy server.</p><p>Accepts the <a href="vboproxy.md"><code>VBOProxy</code></a> object.</p><p>To get this object, run the <a href="get-vboproxy.md"><code>Get-VBOProxy</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vboproxy.md"><code>VBOProxy</code></a></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">ProxyPool</span></p>
        </td>
        <td>
          <p>Specifies a backup proxy pool. The cmdlet will map a new Amazon S3 object storage repository to this backup proxy pool.</p><p>Accepts the <a href="vboproxypool.md"><code>VBOProxyPool</code></a> object.</p><p>To get this object, run the <a href="get-vboproxypool.md"><code>Get-VBOProxyPool</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vboproxypool.md"><code>VBOProxyPool</code></a></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">RetentionFrequencyType</span></p>
        </td>
        <td>
          <p>Specifies retention policy schedule. Veeam Backup for Microsoft 365 will check the object storage repository and will remove the outdated backups according to this schedule. You can set either of the following types of schedule:</p><ul><li><p><code>Daily</code>: to check and remove the outdated backups once a day.</p><p>Set the <code>DailyTime</code> and <code>DailyType</code> parameters to specify the daily retention policy schedule.</p></li><li><p><code>Monthly</code>: to check and remove the outdated backups once a month.</p><p>Set the <code>MonthlyTime</code>, <code>MonthlyDayNumber</code> and <code>MonthlyDayOfWeek</code> parameters to specify the monthly retention policy schedule.</p></li></ul><p>Default: <em>Daily</em></p>
        </td>
        <td style="width:10%;">
          <p><code>VBORetentionFrequencyType</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">RetentionPeriod</span></p>
        </td>
        <td>
          <p>Specifies the retention period in years. Veeam Backup for Microsoft 365 will remove items from the object storage repository once this period is passed. You can set either of the following periods:</p><ul><li><code>Year1</code></li><li><code>Years2</code></li><li><code>Years3</code></li><li><code>Years5</code></li><li><code>Years7</code></li><li><code>Years10</code></li><li><code>Years25</code></li><li><code>KeepForever</code></li></ul><p>Default: <em>Years3</em></p><p><strong>Note</strong>: Apply the <code>CustomRetentionPeriodType</code> parameter to set the retention period in months or days.</p>
        </td>
        <td style="width:10%;">
          <p><code>VBORetentionPeriod</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">RetentionType</span></p>
        </td>
        <td>
          <p>Specifies a type of retention policy. You can set either of the following types:</p><ul><li><code>ItemLevel</code></li><li><code>SnapshotBased</code></li></ul><p>Default: <em>SnapshotBased</em></p>
        </td>
        <td style="width:10%;">
          <p><code>VBORetentionType</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">SizeLimit</span></p>
        </td>
        <td>
          <p>Specifies a soft limit in GB for the object storage repository consumption that can be exceeded temporarily. If the specified limit is exceeded, Veeam Backup for Microsoft 365 will not run a new job.</p><p>Permitted values: 1024–1073741824.</p><p>Default: <em>1024</em></p><p><strong>Note</strong>: In PowerShell you can specify a soft limit in GB only.</p>
        </td>
        <td style="width:10%;">
          <p><code>UInt64</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">SyncNow</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will start to synchronize cache between the object storage repository and the <em>PersistentCache</em> database on the PostgreSQL instance.</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>
    </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 [`VBOAmazonS3ObjectStorageRepository`](vboamazons3objectstoragerepository.md) object that contains settings of Amazon S3 object storage repository.

## Examples

::: example
### Example 1: Adding Amazon S3 Glacier Object Storage with Default Retention Policy Period

This example shows how to add the *Amazon S3 Glacier Deep Archive Backup* object storage repository. The retention type is set to snapshot-based.

```
$proxy = Get-VBOProxy -Hostname support.north.local
$account = Get-VBOAmazonS3Account -Id 26e61916-0257-4a05-8f65-204628d2ed7a
$connection = New-VBOAmazonS3ConnectionSettings -Account $account -RegionType Global
$bucket = Get-VBOAmazonS3Bucket -AmazonS3ConnectionSettings $connection -RegionId eu-north-1 -Name "BucketName"
$folder = Get-VBOAmazonS3Folder -Bucket $bucket -Name "FolderName"
$settings = New-VBOAmazonS3ObjectStorageSettings -Folder $folder
Add-VBOAmazonS3GlacierRepository -Proxy $proxy -Name "Amazon S3 Glacier Deep Archive Backup" -Description "Backup" -RetentionType SnapshotBased -ObjectStorageSettings $settings
```

Perform the following steps:

1. Run the [`Get-VBOProxy`](get-vboproxy.md) cmdlet. Specify the `Hostname` parameter value. Save the result to the `$proxy` variable.
2. Run the [`Get-VBOAmazonS3Account`](get-vboamazons3account.md) cmdlet. Specify the `Id` parameter value. Save the result to the `$account` variable.
3. Run the [`New-VBOAmazonS3ConnectionSettings`](new-vboamazons3connectionsettings.md) cmdlet. Set the `$account` variable as the `Account` parameter value. Specify the `RegionType` parameter value. Save the result to the `$connection` variable.
4. Run the [`Get-VBOAmazonS3Bucket`](get-vboamazons3bucket.md) cmdlet. Set the `$connection` variable as the `AmazonS3ConnectionSettings` parameter value. Specify the `RegionId` parameter value. Specify the `Name` parameter value. Save the result to the `$bucket` variable.
5. Run the [`Get-VBOAmazonS3Folder`](get-vboamazons3folder.md) cmdlet. Set the `$bucket` variable as the `Bucket` parameter value. Specify the `Name` parameter value. Save the result to the `$folder` variable.
6. Run the [`New-VBOAmazonS3ObjectStorageSettings`](new-vboamazons3objectstoragesettings.md) cmdlet. Set the `$folder` variable as the `Folder` parameter value. Save the result to the `$settings` variable.
7. Run the `Add-VBOAmazonS3GlacierRepository` cmdlet. Specify the following settings:

   - Set the `$proxy` variable as the `Proxy` parameter value.
   - Specify the `Name` parameter value.
   - Specify the `Description` parameter value.
   - Set `SnapshotBased` as the `RetentionType` parameter value.
   - Set the `$settings` variable as the `ObjectStorageSettings` parameter value.

:::

::: example
### Example 2: Adding Amazon S3 Glacier Object Storage with Yearly Retention Period [Policy Applied Daily]

This example shows how to add the *Amazon S3 Glacier Deep Archive Backup* object storage repository.

The retention settings will be the following:

- The retention period is set to 1 year.
- Veeam Backup for Microsoft 365 will check the object storage repository and remove the outdated backups daily at 3:00 PM.
- The retention type is item-level.

```
$proxy = Get-VBOProxy -Id d96f55a4-d15d-410b-b0f0-d51d17ccdab6
$account = Get-VBOAmazonS3Account -Id 26e61916-0257-4a05-8f65-204628d2ed7a
$connection = New-VBOAmazonS3ConnectionSettings -Account $account -RegionType Global
$bucket = Get-VBOAmazonS3Bucket -AmazonS3ConnectionSettings $connection -RegionId eu-north-1 -Name "BucketName"
$folder = Get-VBOAmazonS3Folder -Bucket $bucket -Name "FolderName"
$settings = New-VBOAmazonS3ObjectStorageSettings -Folder $folder
Add-VBOAmazonS3GlacierRepository -Proxy $proxy -Name "Amazon S3 Glacier Deep Archive Backup" -RetentionPeriod Year1 -RetentionFrequencyType Daily -DailyTime 15:00:00 -DailyType Everyday -Description "Daily Backup" -RetentionType ItemLevel -ObjectStorageSettings $settings
```

Perform the following steps:

1. Run the [`Get-VBOProxy`](get-vboproxy.md) cmdlet. Specify the `Id` parameter value. Save the result to the `$proxy` variable.
2. Run the [`Get-VBOAmazonS3Account`](get-vboamazons3account.md) cmdlet. Specify the `Id` parameter value. Save the result to the `$account` variable.
3. Run the [`New-VBOAmazonS3ConnectionSettings`](new-vboamazons3connectionsettings.md) cmdlet. Set the `$account` variable as the `Account` parameter value. Specify the `RegionType` parameter value. Save the result to the `$connection` variable.
4. Run the [`Get-VBOAmazonS3Bucket`](get-vboamazons3bucket.md) cmdlet. Set the `$connection` variable as the `AmazonS3ConnectionSettings` parameter value. Specify the `RegionId` parameter value. Specify the `Name` parameter value. Save the result to the `$bucket` variable.
5. Run the [`Get-VBOAmazonS3Folder`](get-vboamazons3folder.md) cmdlet. Set the `$bucket` variable as the `Bucket` parameter value. Specify the `Name` parameter value. Save the result to the `$folder` variable.
6. Run the [`New-VBOAmazonS3ObjectStorageSettings`](new-vboamazons3objectstoragesettings.md) cmdlet. Set the `$folder` variable as the `Folder` parameter value. Save the result to the `$settings` variable.
7. Run the `Add-VBOAmazonS3GlacierRepository` cmdlet. Specify the following settings:

   - Set the `$proxy` variable as the `Proxy` parameter value.
   - Specify the `Name` parameter value.
   - Set `Year1` as the `RetentionPeriod` parameter value.
   - Set `Daily` as the `RetentionFrequencyType` parameter value.
   - Set `15:00:00` as the `DailyTime` parameter value.
   - Set `Everyday` as the `DailyType` parameter value.
   - Specify the `Description` parameter value.
   - Set `ItemLevel` as the `RetentionType` parameter value.
   - Set the `$settings` variable as the `ObjectStorageSettings` parameter value.

:::

::: example
### Example 3: Adding Amazon S3 Glacier Object Storage with Yearly Retention Period [Policy Applied Monthly]

This example shows how to add the *Amazon S3 Glacier Deep Archive Backup* object storage repository.

The retention settings will be the following:

- The retention period is 2 years.
- Veeam Backup for Microsoft 365 will check the object storage repository and remove the outdated backups every last Sunday at 2:00 PM.
- The retention type is snapshot-based.

```
$proxy = Get-VBOProxy -Hostname support.south.local
$account = Get-VBOAmazonS3Account -Id 26e61916-0257-4a05-8f65-204628d2ed7a
$connection = New-VBOAmazonS3ConnectionSettings -Account $account -RegionType Global
$bucket = Get-VBOAmazonS3Bucket -AmazonS3ConnectionSettings $connection -RegionId eu-north-1 -Name "BucketName"
$folder = Get-VBOAmazonS3Folder -Bucket $bucket -Name "FolderName"
$settings = New-VBOAmazonS3ObjectStorageSettings -Folder $folder
Add-VBOAmazonS3GlacierRepository -Proxy $proxy -Name "Amazon S3 Glacier Deep Archive Backup" -RetentionPeriod Year2 -RetentionFrequencyType Monthly -MonthlyTime 14:00:00 -MonthlyDayNumber Last -MonthlyDayOfWeek Sunday -Description "Monthly Backup" -RetentionType SnapshotBased -ObjectStorageSettings $settings
```

Perform the following steps:

1. Run the [`Get-VBOProxy`](get-vboproxy.md) cmdlet. Specify the `Hostname` parameter value. Save the result to the `$proxy` variable.
2. Run the [`Get-VBOAmazonS3Account`](get-vboamazons3account.md) cmdlet. Specify the `Id` parameter value. Save the result to the `$account` variable.
3. Run the [`New-VBOAmazonS3ConnectionSettings`](new-vboamazons3connectionsettings.md) cmdlet. Set the `$account` variable as the `Account` parameter value. Specify the `RegionType` parameter value. Save the result to the `$connection` variable.
4. Run the [`Get-VBOAmazonS3Bucket`](get-vboamazons3bucket.md) cmdlet. Set the `$connection` variable as the `AmazonS3ConnectionSettings` parameter value. Specify the `RegionId` parameter value. Specify the `Name` parameter value. Save the result to the `$bucket` variable.
5. Run the [`Get-VBOAmazonS3Folder`](get-vboamazons3folder.md) cmdlet. Set the `$bucket` variable as the `Bucket` parameter value. Specify the `Name` parameter value. Save the result to the `$folder` variable.
6. Run the [`New-VBOAmazonS3ObjectStorageSettings`](new-vboamazons3objectstoragesettings.md) cmdlet. Set the `$folder` variable as the `Folder` parameter value. Save the result to the `$settings` variable.
7. Run the `Add-VBOAmazonS3GlacierRepository` cmdlet. Specify the following settings:

   - Set the `$proxy` variable as the `Proxy` parameter value.
   - Specify the `Name` parameter value.
   - Set `Years2` as the `RetentionPeriod` parameter value.
   - Set `Monthly` as the `RetentionFrequencyType` parameter value.
   - Set `14:00:00` as the `MonthlyTime` parameter value.
   - Set `Last` as the `MonthlyDayNumber` parameter value.
   - Set `Sunday` as the `MonthlyDayOfWeek` parameter value.
   - Specify the `Description` parameter value.
   - Set `SnapshotBased` as the `RetentionType` parameter value.
   - Set the `$settings` variable as the `ObjectStorageSettings` parameter value.

:::

::: example
### Example 4: Adding Amazon S3 Glacier Object Storage with Custom Retention period [Policy Applied Daily]

This example shows how to add the *Amazon S3 Glacier Deep Archive Backup* object storage repository.

The retention settings will be the following:

- The retention period is 3 months.
- Veeam Backup for Microsoft 365 will check the object storage repository and remove the outdated backups daily at 12:00 PM.
- The retention type is snapshot-based.

```
$proxy = Get-VBOProxy -Id d96f55a4-d15d-410b-b0f0-d51d17ccdab6
$account = Get-VBOAmazonS3Account -Id 26e61916-0257-4a05-8f65-204628d2ed7a
$connection = New-VBOAmazonS3ConnectionSettings -Account $account -RegionType Global
$bucket = Get-VBOAmazonS3Bucket -AmazonS3ConnectionSettings $connection -RegionId eu-north-1 -Name "BucketName"
$folder = Get-VBOAmazonS3Folder -Bucket $bucket -Name "FolderName"
$settings = New-VBOAmazonS3ObjectStorageSettings -Folder $folder
Add-VBOAmazonS3GlacierRepository -Proxy $proxy -Name "Amazon S3 Glacier Deep Archive Backup" -CustomRetentionPeriodType Months -CustomRetentionPeriod 3 -RetentionFrequencyType Daily -DailyTime 12:00:00 -DailyType Workdays -Description "Daily Backup" -RetentionType SnapshotBased -ObjectStorageSettings $settings
```

Perform the following steps:

1. Run the [`Get-VBOProxy`](get-vboproxy.md) cmdlet. Specify the `Id` parameter value. Save the result to the `$proxy` variable.
2. Run the [`Get-VBOAmazonS3Account`](get-vboamazons3account.md) cmdlet. Specify the `Id` parameter value. Save the result to the `$account` variable.
3. Run the [`New-VBOAmazonS3ConnectionSettings`](new-vboamazons3connectionsettings.md) cmdlet. Set the `$account` variable as the `Account` parameter value. Specify the `RegionType` parameter value. Save the result to the `$connection` variable.
4. Run the [`Get-VBOAmazonS3Bucket`](get-vboamazons3bucket.md) cmdlet. Set the `$connection` variable as the `AmazonS3ConnectionSettings` parameter value. Specify the `RegionId` parameter value. Specify the `Name` parameter value. Save the result to the `$bucket` variable.
5. Run the [`Get-VBOAmazonS3Folder`](get-vboamazons3folder.md) cmdlet. Set the `$bucket` variable as the `Bucket` parameter value. Specify the `Name` parameter value. Save the result to the `$folder` variable.
6. Run the [`New-VBOAmazonS3ObjectStorageSettings`](new-vboamazons3objectstoragesettings.md) cmdlet. Set the `$folder` variable as the `Folder` parameter value. Save the result to the `$settings` variable.
7. Run the `Add-VBOAmazonS3GlacierRepository` cmdlet. Specify the following settings:

   - Set the `$proxy` variable as the `Proxy` parameter value.
   - Specify the `Name` parameter value.
   - Set `Months` as the `CustomRetentionPeriodType` parameter value.
   - Set `3` as the `CustomRetentionPeriod` parameter value.
   - Set `Daily` as the `RetentionFrequencyType` parameter value.
   - Set `12:00:00` as the `DailyTime` parameter value.
   - Set `Workdays` as the `DailyType` parameter value.
   - Specify the `Description` parameter value.
   - Set `SnapshotBased` as the `RetentionType` parameter value.
   - Set the `$settings` variable as the `ObjectStorageSettings` parameter value.

:::

::: example
### Example 5: Adding Amazon S3 Glacier Object Storage with Custom Retention period [Policy Applied Monthly]

This example shows how to add the *Amazon S3 Glacier Deep Archive Backup* object storage repository.

The retention settings will be the following:

- The retention period is 7 days.
- Veeam Backup for Microsoft 365 will check the object storage repository and remove the outdated backups every first Monday at 8:00 AM.
- The retention type is item-level.

```
$proxy = Get-VBOProxy -Hostname support.west.local
$account = Get-VBOAmazonS3Account -Id 26e61916-0257-4a05-8f65-204628d2ed7a
$connection = New-VBOAmazonS3ConnectionSettings -Account $account -RegionType Global
$bucket = Get-VBOAmazonS3Bucket -AmazonS3ConnectionSettings $connection -RegionId eu-north-1 -Name "BucketName"
$folder = Get-VBOAmazonS3Folder -Bucket $bucket -Name "FolderName"
$settings = New-VBOAmazonS3ObjectStorageSettings -Folder $folder
Add-VBOAmazonS3GlacierRepository -Proxy $proxy -Name "Amazon S3 Glacier Deep Archive Backup" -CustomRetentionPeriodType Days -CustomRetentionPeriod 7 -RetentionFrequencyType Monthly -MonthlyTime 08:00:00 -MonthlyDayNumber First -MonthlyDayOfWeek Monday -Description "Monthly Backup" -RetentionType ItemLevel -ObjectStorageSettings $settings
```

Perform the following steps:

1. Run the [`Get-VBOProxy`](get-vboproxy.md) cmdlet. Specify the `Hostname` parameter value. Save the result to the `$proxy` variable. 
2. Run the [`Get-VBOAmazonS3Account`](get-vboamazons3account.md) cmdlet. Specify the `Id` parameter value. Save the result to the `$account` variable.
3. Run the [`New-VBOAmazonS3ConnectionSettings`](new-vboamazons3connectionsettings.md) cmdlet. Set the `$account` variable as the `Account` parameter value. Specify the `RegionType` parameter value. Save the result to the `$connection` variable.
4. Run the [`Get-VBOAmazonS3Bucket`](get-vboamazons3bucket.md) cmdlet. Set the `$connection` variable as the `AmazonS3ConnectionSettings` parameter value. Specify the `RegionId` parameter value. Specify the `Name` parameter value. Save the result to the `$bucket` variable.
5. Run the [`Get-VBOAmazonS3Folder`](get-vboamazons3folder.md) cmdlet. Set the `$bucket` variable as the `Bucket` parameter value. Specify the `Name` parameter value. Save the result to the `$folder` variable.
6. Run the [`New-VBOAmazonS3ObjectStorageSettings`](new-vboamazons3objectstoragesettings.md) cmdlet. Set the `$folder` variable as the `Folder` parameter value. Save the result to the `$settings` variable.
7. Run the `Add-VBOAmazonS3GlacierRepository` cmdlet. Specify the following settings:

   - Set the `$proxy` variable as the `Proxy` parameter value.
   - Specify the `Name` parameter value.
   - Set `Days` as the `CustomRetentionPeriodType` parameter value.
   - Set `7` as the `CustomRetentionPeriod` parameter value.
   - Set `Monthly` as the `RetentionFrequencyType` parameter value.
   - Set `08:00:00` as the `MonthlyTime` parameter value.
   - Set `First` as the `MonthlyDayNumber` parameter value.
   - Set `Monday` as the `MonthlyDayOfWeek` parameter value.
   - Specify the `Description` parameter value.
   - Set `ItemLevel` as the `RetentionType` parameter value.
   - Set the `$settings` variable as the `ObjectStorageSettings` parameter value.

:::

## Related Commands

- [`Get-VBOProxy`](get-vboproxy.md)
- [`Get-VBOProxyPool`](get-vboproxypool.md)
- [`Get-VBOEncryptionKey`](get-vboencryptionkey.md)
- [`Get-VBOAmazonS3Account`](get-vboamazons3account.md)
- [`New-VBOAmazonS3ConnectionSettings`](new-vboamazons3connectionsettings.md)
- [`Get-VBOAmazonS3Bucket`](get-vboamazons3bucket.md)
- [`Get-VBOAmazonS3Folder`](get-vboamazons3folder.md)
- [`New-VBOAmazonS3ObjectStorageSettings`](new-vboamazons3objectstoragesettings.md)