---
title: "Set-VBRS3CompatibleRepositorySecurityOptions"
description: "This cmdlet modifies settings that Veeam Agent uses to access S3 compatible repositories. To modify settings, specify new values for the necessary parameters. The cmdlet will overwrite the previous parameter values with new values."
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/set-vbrs3compatiblerepositorysecurityoptions.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Backup Infrastructure > Object Storage Repositories > Managing Object Storage Repositories > Set-VBRS3CompatibleRepositorySecurityOptions"
dateModified: "2026-08-19"
---

# Set-VBRS3CompatibleRepositorySecurityOptions

## Short Description
Modifies settings that Veeam Agent uses to access S3 compatible repositories.

**Platform**: VMware, Hyper-V

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

## Syntax
```
Set-VBRS3CompatibleRepositorySecurityOptions -Repository <VBRAmazonS3CompatibleRepository>
 [-AccessControlPolicy <VBRS3CompatibleAccessControlPolicyType>] [-IAMEndpoint <String>]
 [-STSEndpoint <String>] [<CommonParameters>]
```

## Detailed Description
This cmdlet modifies settings that Veeam Agent uses to access S3 compatible repositories.

::: note

To modify settings, specify new values for the necessary parameters. The cmdlet will overwrite the previous parameter values 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">AccessControlPolicy</span></p>
        </td>
        <td>
          <p>Specifies how Veeam Agent accesses S3 compatible repositories:</p><ul><li><code>AllowAll</code> — use this option if you want Veeam Agent to access S3 compatible directly using credentials for the S3 compatible bucket.</li><li><code>S3CompatibleManaged</code> — use this option if you want Veeam Agent to access S3 compatible repositories directly using secure credentials with a service token. <strong>Note</strong>: use the <code>IAMEndpoint</code> and <code>STSEndpoint</code> parameters to specify these credentials.</li><li><code>VBRManaged</code> — use this option if you want Veeam Agent to access S3 compatible repositories through gateway servers.</li></ul>
        </td>
        <td style="width:10%;">
          <p><code>VBRS3CompatibleAccessControlPolicyType</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">IAMEndpoint</span></p>
        </td>
        <td>
          <p>For the direct secure connection with a service token.</p><p>Specifies an endpoint of your S3 compatible repository. The cmdlet will use this host to connect to this 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 an S3 compatible repository. The cmdlet will modify settings that Veeam Agent uses to access this repository.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbramazons3compatiblerepository.md"><code>VBRAmazonS3CompatibleRepository</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 (ByPropertyName, ByValue)</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">STSEndpoint</span></p>
        </td>
        <td>
          <p>For the direct secure connection with a service token.</p><p>Specifies the security token of your S3 compatible repository. The cmdlet will use this security token to connect to this 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>
    </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
[`VBRS3CompatibleRepositorySecurityOptions`](vbrs3compatiblerepositorysecurityoptions.md)

## Examples

::: example
### Example 1. Setting Direct Access to S3 Compatible Repositories [Using Bucket Credentials]

This example shows how to set Veeam Agent to access S3 compatible repositories directly using credentials for the S3 compatible bucket.

```
$s3repository = Get-VBRObjectStorageRepository -Name "S3 Compatible Repository"
Set-VBRS3CompatibleRepositorySecurityOptions -Repository $s3repository -AccessControlPolicy AllowAll
```

Perform the following steps:

1. Run the [`Get-VBRObjectStorageRepository`](get-vbrobjectstoragerepository.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$s3repository` variable.
2. Run the `Set-VBRS3CompatibleRepositorySecurityOptions` cmdlet. Set the `$s3repository` variable as the `Repository` parameter value. Set the `AllowAll` option for the `AccessControlPolicy` parameter.

:::

::: example
### Example 2. Setting Direct Access to S3 Compatible Repositories [Using Service Token]

This example shows how to set Veeam Agent to access S3 compatible repositories directly. The cmdlet will connect to the `iam.wasabisys.com`  endpoint and will use secure credentials with the `sts.wasabisys.com` service token.

```
$s3repository = Get-VBRObjectStorageRepository -Name "S3 Compatible Repository"
Set-VBRS3CompatibleRepositorySecurityOptions -Repository $s3repository -AccessControlPolicy S3CompatibleManaged -IAMEndpoint "iam.wasabisys.com" -STSEndpoint "sts.wasabisys.com"
```

Perform the following steps:

1. Run the [`Get-VBRObjectStorageRepository`](get-vbrobjectstoragerepository.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$s3repository` variable.
2. Run the `Set-VBRS3CompatibleRepositorySecurityOptions` cmdlet. Specify the following settings:

   - Set the `$s3repository` variable as the `Repository` parameter value.
   - Set the `S3CompatibleManaged` option for the `AccessControlPolicy` parameter.
   - Specify the `IAMEndpoint` parameter value.
   - Specify the `STSEndpoint` parameter value.

:::

::: example
### Example 3. Setting Access Through Gateway Server to S3 Compatible Repositories

This example shows how to set Veeam Agent to access S3 compatible repositories directly using credentials for the S3 compatible bucket.

```
$s3repository = Get-VBRObjectStorageRepository -Name "S3 Compatible Repository"
Set-VBRS3CompatibleRepositorySecurityOptions -Repository $s3repository -AccessControlPolicy VBRManaged
```

Perform the following steps:

1. Run the [`Get-VBRObjectStorageRepository`](get-vbrobjectstoragerepository.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$s3repository` variable.
2. Run the `Set-VBRS3CompatibleRepositorySecurityOptions` cmdlet. Set the `$s3repository` variable as the `Repository` parameter value. Set the `VBRManaged` option for the `AccessControlPolicy` parameter.

:::

## Related Commands

[`Get-VBRObjectStorageRepository`](get-vbrobjectstoragerepository.md)