---
title: "Connect-VBRAmazonS3CompatibleService"
description: "This cmdlet connects to S3 compatible object storage. It creates the IVBRAmazonS3Connection object that contains the connection settings for the following types of storage: S3 compatible object storage S3 compatible object storage with data..."
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/connect-vbramazons3compatibleservice.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Backup Infrastructure > Cloud Credentials > Amazon S3 Accounts > Managing Amazon Connection Service > Connect-VBRAmazonS3CompatibleService"
dateModified: "2026-08-19"
---

# Connect-VBRAmazonS3CompatibleService

## Short Description
Connects to S3 compatible object storage.

**Platform**: VMware, Hyper-V

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

## Syntax
```
Connect-VBRAmazonS3CompatibleService -Account <VBRAmazonAccount> [-GatewayServer <CHost[]>]
 [-ConnectionType <VBRRepositoryConnectionType>] -CustomRegionId <String> -ServicePoint <String>
 [-ServiceType <VBRAmazonServiceType>] [-Force] [<CommonParameters>]
```

## Detailed Description
This cmdlet connects to S3 compatible object storage. It creates the `IVBRAmazonS3Connection` object that contains the connection settings for the following types of storage:

- S3 compatible object storage
- S3 compatible object storage with data archiving
- AWS Snowball Edge device
- Wasabi Cloud Object Storage

You can use these settings to add S3 compatible devices to the backup infrastructure as the following types of repositories:

- An object storage repository. Run the [`Add-VBRAmazonS3CompatibleRepository`](add-vbramazons3compatiblerepository.md) cmdlet to add S3 compatible object storage as an object storage repository.
- An external repository. Run the [`Add-VBRAmazonS3ExternalRepository`](add-vbramazons3externalrepository.md) cmdlet to add S3 compatible as an external repository.
- A capacity extent of a scale-out backup repository.
- An archive extent of a scale-out backup repository.

::: note

Consider the following:

- It is recommended to disconnect the S3 compatible session at the end. Otherwise, the information that you get within the session will not be refreshed when you connect again, and outdated data will be used then. Run the [`Disconnect-VBRAmazonS3Service`](disconnect-vbramazons3service.md) cmdlet to stop the session.
- To get an active session, save the result that you get after you run the `Connect-VBRAmazonS3CompatibleService` cmdlet to a variable.

:::

## 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">Account</span></p>
        </td>
        <td>
          <p>Specifies an S3 compatible service credentials record. Veeam Backup & Replication will use this credentials record to connect to S3 compatible object storage or S3 compatible object storage with data archiving.</p><p>Accepts the <code>VBRAmazonAccount</code> object. To create this object, run the <a href="get-vbramazonaccount.md"><code>Get-VBRAmazonAccount</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbramazonaccount.md"><code>VBRAmazonAccount</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">ConnectionType</span></p>
        </td>
        <td>
          <p>Specifies how Veeam Backup & Replication will access the object storage repository:</p><ul><li><code>Direct</code>: Use this option if you want Veeam Backup & Replication to use a proxy server to transfer data from the processed VM to object storage repositories.</li><li><code>Gateway</code>: Use this option if you want Veeam Backup & Replication to use a gateway server to transfer data from processed VM to object storage repositories. <strong>Note</strong>: Provide the <code>GatewayServer</code> parameter to specify the server.</li></ul><p>Default: <code>Direct</code>.</p>
        </td>
        <td style="width:10%;">
          <p><code>VBRRepositoryConnectionType</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">CustomRegionId</span></p>
        </td>
        <td>
          <p>Specifies an Amazon S3 region where your S3 compatible object storage or or S3 compatible object storage with data archiving are located.</p><p><strong>Note</strong>: To connect to the AWS Snowball Edge device, you must provide the <code>snow</code> value for the <code>CustomRegionId</code> parameter.</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">Force</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will set up a connection to S3 compatible object storage even if Veeam Backup & Replication or Veeam Agent cannot validate that the certificate is issued from the trusted authorities.</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">GatewayServer</span></p>
        </td>
        <td>
          <p>Specifies an array of gateway servers that you want to use to transfer data from processed VM to object storage repositories.</p><p><strong>Note</strong>: If you use S3 compatible service credentials records to connect to S3 compatible object storage with data archiving, the cmdlet will ignore these gateway server settings. It will use the settings that you specify for an archiver appliance.</p>
        </td>
        <td style="width:10%;">
          <p><code>CHost[]</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">ServicePoint</span></p>
        </td>
        <td>
          <p>Specifies the endpoint. The cmdlet will use this endpoint to connect to S3 compatible object storage or S3 compatible object storage with data archiving.</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">ServiceType</span></p>
        </td>
        <td>
          <p>Specifies the type of the backup repository. The cmdlet will add the object storage as the specified type of the backup repository to the backup infrastructure.</p><ul><li><code>ExternalRepository</code>: Use this option to add object storage as an external backup repository.</li><li><code>CapacityTier</code>: Use this option to add object storage as a capacity extent or an object storage repository.</li><li><code>ArchiveTier</code>: Use this option to add object storage as an archive extent.</li></ul>
        </td>
        <td style="width:10%;">
          <p><code>VBRAmazonServiceType</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
[`VBRAmazonS3CompatibleRepository`](vbramazons3compatiblerepository.md)

## Examples

::: example
### Example 1. Connecting to S3 Compatible Object Storage

This example shows how to connect to S3 compatible object storage.

```
$account = Get-VBRAmazonAccount -AccessKey "XXXXXXXXXXXXXXX"
Connect-VBRAmazonS3CompatibleService -Account $account -CustomRegionId "us-east-1" -ServicePoint "http://123.45.67.89:9000"
```

Perform the following steps:

1. Run the [`Get-VBRAmazonAccount`](get-vbramazonaccount.md) cmdlet. Specify the `AccessKey` parameter value. Save the result to the `$account` variable.
2. Run the `Connect-VBRAmazonS3CompatibleService` cmdlet. Specify the following settings:

   - Set the `$account` variable as the `Account` parameter value.
   - Specify the `CustomRegionId` parameter value.
   - Specify the `ServicePoint` parameter value.

:::

::: example
### Example 2. Connecting to AWS Snowball Edge

This example shows how to connect to AWS Snowball Edge.

```
$account = Get-VBRAmazonAccount -AccessKey "XXXXXXXXXXXXXXX"
Connect-VBRAmazonS3CompatibleService -Account $account -CustomRegionId "snow" -ServicePoint "http://123.45.67.89:9000"
```

Perform the following steps:

1. Run the [`Get-VBRAmazonAccount`](get-vbramazonaccount.md) cmdlet. Specify the `AccessKey` parameter value. Save the result to the `$account` variable.
2. Run the `Connect-VBRAmazonS3CompatibleService` cmdlet. Specify the following settings:

   - Set the `$account` variable as the `Account` parameter value.
   - Specify the `CustomRegionId` parameter value.
   - Specify the `ServicePoint` parameter value.

:::

## Related Commands

[`Get-VBRAmazonAccount`](get-vbramazonaccount.md)