---
title: "Add-VBOAmazonS3CompatibleObjectStorageRepository"
description: "This cmdlet adds S3 Compatible object storage repository, IBM Cloud Object Storage or Wasabi Cloud Object Storage to the Veeam Backup for Microsoft 365 infrastructure."
canonical: "https://helpcenter.veeam.com/docs/vbo365/powershell/add-vboamazons3compatibleobjectstoragerepository.html"
breadcrumb: "PowerShell Reference > Veeam Backup for Microsoft 365 PowerShell Reference > Backup Infrastructure > JET-based Backup Repositories and Object Storage Repositories > Object Storage Deprecated Cmdlets > Add-VBOAmazonS3CompatibleObjectStorageRepository"
dateModified: "2026-08-21"
---

# Add-VBOAmazonS3CompatibleObjectStorageRepository

## Short Description
Adds S3 Compatible object storage repository to the Veeam Backup for Microsoft 365 infrastructure.

::: note

In Veeam Backup for Microsoft 365 8, this cmdlet became deprecated. Use the [`New-VBOAmazonS3CompatibleObjectStorageSettings`](new-vboamazons3compatibleobjectstoragesettings.md) and [`Add-VBOAmazonS3CompatibleRepository`](add-vboamazons3compatiblerepository.md) cmdlets instead.

:::

## Syntax
```
Add-VBOAmazonS3CompatibleObjectStorageRepository -Folder <VBOAmazonS3Folder>
 [-Type <AddAmazonS3CompatibleObjectStorageType>] -Name <String> [-Description <String>] [-SizeLimit <UInt64>]
 [-EnableImmutability] [-ImmutabilityPeriodDays <Int32>] [<CommonParameters>]
```

## Detailed Description
This cmdlet adds S3 Compatible object storage repository, IBM Cloud Object Storage or Wasabi Cloud Object Storage to the Veeam Backup for Microsoft 365 infrastructure.

## 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">Description</span></p>
        </td>
        <td>
          <p>Specifies a description of S3 Compatible object storage repository. The cmdlet will add an object storage repository with this 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">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">Folder</span></p>
        </td>
        <td>
          <p>Specifies an S3 Compatible folder. Veeam Backup for Microsoft 365 will save backups or backup copies to the specified folder.</p><p>Accepts the <a href="vboamazons3folder.md"><code>VBOAmazonS3Folder</code></a> object.</p><p>To get this object, run the <a href="get-vboamazons3folder.md"><code>Get-VBOAmazonS3Folder</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vboamazons3folder.md"><code>VBOAmazonS3Folder</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">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">Name</span></p>
        </td>
        <td>
          <p>Specifies a name of S3 Compatible 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">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">Type</span></p>
        </td>
        <td>
          <p>Specifies a type of S3 Compatible object storage repository. The cmdlet will add an object storage repository of one of the following types:</p><ul><li><em>AmazonS3Compatible</em></li><li><em>IBMCloud</em></li><li><em>WasabiCloud</em></li></ul>
        </td>
        <td style="width:10%;">
          <p><code>AddAmazonS3CompatibleObjectStorageType</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: Adding S3 Compatible Object Storage

This example shows how to add S3 Compatible object storage repository.

```
$account = Get-VBOAmazonS3CompatibleAccount -Id 1dfc5af0-2605-47ac-94d8-13dea4d14608
$connection = New-VBOAmazonS3CompatibleConnectionSettings -Account $account -ServicePoint "172.17.186.13:9000"
$bucket = Get-VBOAmazonS3Bucket -AmazonS3CompatibleConnectionSettings $connection -Name "BucketName"
$folder = Get-VBOAmazonS3Folder -Bucket $bucket -Name "Reports 09"
Add-VBOAmazonS3CompatibleObjectStorageRepository -Folder $folder -Type AmazonS3Compatible -Name "Documents"
```

Perform the following steps:

1. Run the [`Get-VBOAmazonS3CompatibleAccount`](get-vboamazons3compatibleaccount.md) cmdlet. Specify the `Id` parameter value. Save the result to the `$account` variable.
2. Run the [`New-VBOAmazonS3CompatibleConnectionSettings`](new-vboamazons3compatibleconnectionsettings.md) cmdlet. Specify the necessary parameters. Save the result to the `$connection` variable.
3. Run the [`Get-VBOAmazonS3Bucket`](get-vboamazons3bucket.md) cmdlet. Specify the necessary parameters. Save the result to the `$bucket` variable.
4. Run the [`Get-VBOAmazonS3Folder`](get-vboamazons3folder.md) cmdlet. Specify the necessary parameters. Save the result to the `$folder` variable.
5. Run the `Add-VBOAmazonS3CompatibleObjectStorageRepository` cmdlet. Set the `$folder` variable as the `Folder` parameter value. Set `AmazonS3Compatible` as the `Type` parameter value. Specify the `Name` parameter value.

:::

::: example
### Example 2: Adding S3 Compatible Object Storage with Description

This example shows how to add S3 Compatible object storage repository with description.

```
$account = Get-VBOAmazonS3CompatibleAccount -Id 1dfc5af0-2605-47ac-94d8-13dea4d14608
$connection = New-VBOAmazonS3CompatibleConnectionSettings -Account $account -ServicePoint "172.17.186.13:9000"
$bucket = Get-VBOAmazonS3Bucket -AmazonS3CompatibleConnectionSettings $connection -Name "BucketName"
$folder = Get-VBOAmazonS3Folder -Bucket $bucket -Name "Reports 08"
Add-VBOAmazonS3CompatibleObjectStorageRepository -Folder $folder -Name "Documents" -Description "Created by Administrator"
```

Perform the following steps:

1. Run the [`Get-VBOAmazonS3CompatibleAccount`](get-vboamazons3compatibleaccount.md) cmdlet. Specify the `Id` parameter value. Save the result to the `$account` variable.
2. Run the [`New-VBOAmazonS3CompatibleConnectionSettings`](new-vboamazons3compatibleconnectionsettings.md) cmdlet. Specify the necessary parameters. Save the result to the `$connection` variable.
3. Run the [`Get-VBOAmazonS3Bucket`](get-vboamazons3bucket.md) cmdlet. Specify the necessary parameters. Save the result to the `$bucket` variable.
4. Run the [`Get-VBOAmazonS3Folder`](get-vboamazons3folder.md) cmdlet. Specify the necessary parameters. Save the result to the `$folder` variable.
5. Run the `Add-VBOAmazonS3CompatibleObjectStorageRepository` cmdlet. Specify the following settings:

   - Set the `$folder` variable as the `Folder` parameter value.
   - Specify the `Name` parameter value.
   - Specify the `Description` parameter value.

:::

::: example
### Example 3: Adding S3 Compatible Object Storage with Specified Size Limits

This example shows how to add S3 Compatible object storage repository. The repository will be added with size limits set to 5120 GB.

```
$account = Get-VBOAmazonS3CompatibleAccount -Id 1dfc5af0-2605-47ac-94d8-13dea4d14608
$connection = New-VBOAmazonS3CompatibleConnectionSettings -Account $account -ServicePoint "172.17.186.13:9000"
$bucket = Get-VBOAmazonS3Bucket -AmazonS3CompatibleConnectionSettings $connection -Name "BucketName"
$folder = Get-VBOAmazonS3Folder -Bucket $bucket -Name "Reports 07"
Add-VBOAmazonS3CompatibleObjectStorageRepository -Folder $folder -Name "Documents" -SizeLimit 5120
```

Perform the following steps:

1. Run the [`Get-VBOAmazonS3CompatibleAccount`](get-vboamazons3compatibleaccount.md) cmdlet. Specify the `Id` parameter value. Save the result to the `$account` variable.
2. Run the [`New-VBOAmazonS3CompatibleConnectionSettings`](new-vboamazons3compatibleconnectionsettings.md) cmdlet. Specify the necessary parameters. Save the result to the `$connection` variable.
3. Run the [`Get-VBOAmazonS3Bucket`](get-vboamazons3bucket.md) cmdlet. Specify the necessary parameters. Save the result to the `$bucket` variable.
4. Run the [`Get-VBOAmazonS3Folder`](get-vboamazons3folder.md) cmdlet. Specify the necessary parameters. Save the result to the `$folder` variable.
5. Run the `Add-VBOAmazonS3CompatibleObjectStorageRepository` cmdlet. Specify the following settings:

   - Set the `$folder` variable as the `Folder` parameter value.
   - Specify the `Name` parameter value.
   - Specify the `SizeLimit` parameter value.

:::

::: example
### Example 4: Adding S3 Compatible Object Storage of IBMCloud Type with Immutability Enabled

This example shows how to add S3 Compatible object storage repository of the *IBMCloud* type with the enabled immutability.

```
$account = Get-VBOAmazonS3CompatibleAccount -Id 1dfc5af0-2605-47ac-94d8-13dea4d14608
$connection = New-VBOAmazonS3CompatibleConnectionSettings -Account $account -ServicePoint "172.17.186.13:9000"
$bucket = Get-VBOAmazonS3Bucket -AmazonS3CompatibleConnectionSettings $connection -Name "BucketName2"
$folder = Get-VBOAmazonS3Folder -Bucket $bucket -Name "Reports 10"
Add-VBOAmazonS3CompatibleObjectStorageRepository -Folder $folder -Type IBMCloud -Name "NewBackups" -EnableImmutability -ImmutabilityPeriodDays 60
```

Perform the following steps:

1. Run the [`Get-VBOAmazonS3CompatibleAccount`](get-vboamazons3compatibleaccount.md) cmdlet. Specify the `Id` parameter value. Save the result to the `$account` variable.
2. Run the [`New-VBOAmazonS3CompatibleConnectionSettings`](new-vboamazons3compatibleconnectionsettings.md) cmdlet. Specify the necessary parameters. Save the result to the `$connection` variable.
3. Run the [`Get-VBOAmazonS3Bucket`](get-vboamazons3bucket.md) cmdlet. Specify the necessary parameters. Save the result to the `$bucket` variable.
4. Run the [`Get-VBOAmazonS3Folder`](get-vboamazons3folder.md) cmdlet. Specify the necessary parameters. Save the result to the `$folder` variable.
5. Run the `Add-VBOAmazonS3CompatibleObjectStorageRepository` cmdlet. Set the `$folder` variable as the `Folder` parameter value. Set `IBMCloud` as the `Type` parameter value. Specify the `Name` parameter value. Provide the `EnableImmutability` parameter. Specify the `ImmutabilityPeriodDays` parameter value.

:::

## Related Commands

- [`Get-VBOAmazonS3CompatibleAccount`](get-vboamazons3compatibleaccount.md)
- [`New-VBOAmazonS3CompatibleConnectionSettings`](new-vboamazons3compatibleconnectionsettings.md)
- [`Get-VBOAmazonS3Bucket`](get-vboamazons3bucket.md)
- [`Get-VBOAmazonS3Folder`](get-vboamazons3folder.md)