---
title: "Set-VBOAmazonS3CompatibleRepository"
description: "This cmdlet modifies settings of S3 Compatible object storage repository added to the Veeam Backup for Microsoft 365 infrastructure. To modify settings, you need to enter the necessary parameters with new values."
canonical: "https://helpcenter.veeam.com/docs/vbo365/powershell/set-vboamazons3compatiblerepository.html"
breadcrumb: "PowerShell Reference > Veeam Backup for Microsoft 365 PowerShell Reference > Backup Infrastructure > JET-based Backup Repositories and Object Storage Repositories > Set-VBOAmazonS3CompatibleRepository"
dateModified: "2026-08-21"
---

# Set-VBOAmazonS3CompatibleRepository

## Short Description
Modifies settings of S3 Compatible object storage repository.

## Syntax

This cmdlet provides the following parameter sets:

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

```
Set-VBOAmazonS3CompatibleRepository [-TrustServerCertificate] [-EnableSizeLimit] [-SizeLimit <UInt64>]
 [-EnableDefragmentation] [-ImmutabilityPeriodDays <Int32>] -Repository <VBORepository> [-Name <String>]
 [-Description <String>] [-RetentionPeriod <VBORetentionPeriod>]
 [-RetentionFrequencyType <VBORetentionFrequencyType>] [-DailyTime <TimeSpan>] [-DailyType <VBODailyType>]
 [-MonthlyTime <TimeSpan>] [-MonthlyDayNumber <VBOMonthlyDayNumber>] [-MonthlyDayOfWeek <DayOfWeek>] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>CustomRetentionParameterSet</code></p>

```
Set-VBOAmazonS3CompatibleRepository [-TrustServerCertificate] [-EnableSizeLimit] [-SizeLimit <UInt64>]
 [-EnableDefragmentation] [-ImmutabilityPeriodDays <Int32>] -Repository <VBORepository> [-Name <String>]
 [-Description <String>] [-CustomRetentionPeriodType <VBORetentionPeriodType>] [-CustomRetentionPeriod <Int32>]
 [-RetentionFrequencyType <VBORetentionFrequencyType>] [-DailyTime <TimeSpan>] [-DailyType <VBODailyType>]
 [-MonthlyTime <TimeSpan>] [-MonthlyDayNumber <VBOMonthlyDayNumber>] [-MonthlyDayOfWeek <DayOfWeek>] [<CommonParameters>]
```
  </li>
</ul>

## Detailed Description
This cmdlet modifies settings of S3 Compatible object storage repository added to the Veeam Backup for Microsoft 365 infrastructure. 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">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>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">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>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">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>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">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>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">Description</span></p>
        </td>
        <td>
          <p>Specifies a description of S3 Compatible object storage repository. The cmdlet will replace the current description with the specified description.</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">EnableDefragmentation</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will enable defragmentation for the specified S3 Compatible object storage repository. After applying the retention policy, Veeam Backup for Microsoft 365 will start merging small blobs of data into a bigger one.</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">EnableSizeLimit</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will enable a soft limit in GB for the object storage repository consumption that can be exceeded temporarily.</p><p>Use the <code>SizeLimit</code> parameter to specify the soft limit value.</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">ImmutabilityPeriodDays</span></p>
        </td>
        <td>
          <p>Specifies the number of days when your data will be blocked for deletion or modification.</p><p><strong>Note</strong>: If you set the <em>null</em> or <em>0</em> value, data will be blocked for deletion or modification for the same period as the retention period.</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>
      <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>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">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>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">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>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">Name</span></p>
        </td>
        <td>
          <p>Specifies a name of S3 Compatible object storage repository. The cmdlet will change the name of this object storage repository.</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">Repository</span></p>
        </td>
        <td>
          <p>Specifies S3 Compatible object storage repository. The cmdlet will modify settings of this object storage repository.</p><p>Accepts the <a href="vborepository.md"><code>VBORepository</code></a> object.</p><p>To get this object, run the <a href="get-vborepository.md"><code>Get-VBORepository</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vborepository.md"><code>VBORepository</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>True (ByValue)</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>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">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>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>For the <code>EnableSizeLimit</code> option.</p><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">TrustServerCertificate</span></p>
        </td>
        <td>
          <p>Defines that Veeam Backup for Microsoft 365 will trust S3 Compatible self-signed certificates.</p><p>If you omit this parameter, Veeam Backup for Microsoft 365 will not trust S3 Compatible self-signed certificates.</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 S3 Compatible object storage repository.

## Examples

::: example
### Example 1: Modifying Retention Policy Settings

This example shows how to modify retention policy settings for S3 Compatible object storage repository. The repository will have the following settings:

- The retention period is set to 5 years.
- Veeam Backup for Microsoft 365 will check the object storage repository and remove the outdated backups on weekends at 11:59 PM.

```
$repository = Get-VBORepository -Name "S3 Compatible Backup"
Set-VBOAmazonS3CompatibleRepository -Repository $repository -RetentionPeriod Years5 -RetentionFrequencyType Daily -DailyType Weekends -DailyTime 23:59:00
```

Perform the following steps:

1. Run the [`Get-VBORepository`](get-vborepository.md) cmdlet. Save the result to the `$repository` variable.
2. Run the `Set-VBOAmazonS3CompatibleRepository` cmdlet. Specify the following settings:

   - Set the `$repository` variable as the `Repository` parameter value.
   - Set `Years5` as the `RetentionPeriod` parameter value.
   - Set `Daily` as the `RetentionFrequencyType` parameter value.
   - Set `Weekends` as the `DailyType` parameter value.
   - Set `23:59:00` as the `DailyTime` parameter value.

:::

::: example
### Example 2: Modifying S3 Compatible Object Storage Name and Retention Policy

This example shows how to change the name of the *S3 Compatible Backup* object storage repository and configure the clean-up schedule with the following settings:

- The retention period for organization backups is set to 6 months.
- Veeam Backup for Microsoft 365 will check the object storage repository and remove the outdated backups every second Monday at 7:59 AM.

```
$repository = Get-VBORepository -Name "S3 Compatible Backup"
Set-VBOAmazonS3CompatibleRepository -Repository $repository -Name "Monthly Reports" -CustomRetentionPeriodType Months -CustomRetentionPeriod 6 -RetentionFrequencyType Monthly -MonthlyDayNumber Second -MonthlyDayOfWeek Monday -MonthlyTime 07:59:00
```

Perform the following steps:

1. Run the [`Get-VBORepository`](get-vborepository.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$repository` variable.
2. Run the `Set-VBOAmazonS3CompatibleRepository` cmdlet. Specify the following settings:

   - Set the `$repository` variable as the `Repository` parameter value.
   - Specify the `Name` parameter value.
   - Set `Months` as the `CustomRetentionPeriodType` parameter value.
   - Set `6` as the `CustomRetentionPeriod` parameter value.
   - Set `Monthly` as the `RetentionFrequencyType` parameter value.
   - Set `Second` as the `MonthlyDayNumber` parameter value.
   - Set `Monday` as the `MonthlyDayOfWeek` parameter value.
   - Set `07:59:00` as the `MonthlyTime` parameter value.

:::

::: example
### Example 3: Modifying S3 Compatible Object Storage Soft Limit

This example shows how to modify a soft limit for the *S3 Compatible Backup* object storage repository.

```
$repository = Get-VBORepository -Name "S3 Compatible Backup"
Set-VBOAmazonS3CompatibleRepository -Repository $repository -EnableSizeLimit -SizeLimit 2048
```

Perform the following steps:

1. Run the [`Get-VBORepository`](get-vborepository.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$repository` variable.
2. Run the `Set-VBOAmazonS3CompatibleRepository` cmdlet. Specify the following settings:

   - Set the `$repository` variable as the `Repository` parameter value. 
   - Provide the `EnableSizeLimit` parameter.
   - Specify the `SizeLimit` parameter value.

:::

::: example
### Example 4: Disabling S3 Compatible Object Storage Soft Limit

This example shows how to disable the soft limit for the *S3 Compatible Backup* object storage repository.

```
$repository = Get-VBORepository -Name "S3 Compatible Backup"
Set-VBOAmazonS3CompatibleRepository -Repository $repository -EnableSizeLimit:$false
```

Perform the following steps:

1. Run the [`Get-VBORepository`](get-vborepository.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$repository` variable.
2. Run the `Set-VBOAmazonS3CompatibleRepository` cmdlet. Specify the following settings:

   - Set the `$repository` variable as the `Repository` parameter value. 
   - Set the `false` value for the `EnableSizeLimit` parameter.

:::

::: example
### Example 5: Trusting Current S3 Compatible Object Storage Self-Signed Certificate

This example shows how configure Veeam Backup for Microsoft 365 to trust current S3 Compatible self-signed certificate.

```
$repository = Get-VBORepository -Name "S3 Compatible Backup"
Set-VBOAmazonS3CompatibleRepository -Repository $repository -TrustServerCertificate
```

Perform the following steps:

1. Run the [`Get-VBORepository`](get-vborepository.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$repository` variable.
2. Run the `Set-VBOAmazonS3CompatibleRepository` cmdlet. Specify the following settings:

   - Set the `$repository` variable as the `Repository` parameter value. 
   - Provide the `TrustServerCertificate` parameter.

:::

## Related Commands

[`Get-VBORepository`](get-vborepository.md)