---
title: "Connect-VBRAmazonS3Service"
description: "Connects to Amazon S3 object storage. Platform: VMware, Hyper-V Product Edition: Community, Standard, Enterprise, Enterprise Plus, Veeam Universal License This cmdlet connects to Amazon S3 object storage."
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/connect-vbramazons3service.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Backup Infrastructure > Cloud Credentials > Amazon S3 Accounts > Managing Amazon Connection Service > Connect-VBRAmazonS3Service"
dateModified: "2026-08-19"
---

# Connect-VBRAmazonS3Service

## Short Description
Connects to Amazon S3 object storage.

**Platform**: VMware, Hyper-V

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

## Syntax
```
Connect-VBRAmazonS3Service -Account <VBRAmazonAccount> [-GatewayServer <CHost[]>]
 [-ConnectionType <VBRRepositoryConnectionType>] -RegionType <VBRAmazonRegionType>
 -ServiceType <VBRAmazonServiceType> [<CommonParameters>]
```

## Detailed Description
This cmdlet connects to Amazon S3 object storage. It creates the `IVBRAmazonS3Connection` object that contains connection settings that Veeam Backup & Replication will use to connect to Amazon S3 object storage. You can use these settings to add Amazon S3 object storage to the backup infrastructure as the following types of repositories:

- An object storage repository.
- An external repository. Run the [`Add-VBRAmazonS3ExternalRepository`](add-vbramazons3externalrepository.md) cmdlet to add Amazon S3 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 Amazon S3 session at the end of the PowerShell session. 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-VBRAmazonS3Service` 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 Amazon S3 credentials record. Veeam Backup & Replication will use this credentials record to connect to Amazon S3 object storage.</p><p>Accepts the <a href="vbramazonaccount.md"><code>VBRAmazonAccount</code></a> 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">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>
        </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">RegionType</span></p>
        </td>
        <td>
          <p>Specifies the region type of Amazon S3 object storage. Veeam Backup & Replication will connect to the selected region type to set up a connection with Amazon S3 object storage. You can select the following types of regions:</p><ul><li><code>Global</code></li><li><code>Government</code></li><li><code>China</code></li></ul>
        </td>
        <td style="width:10%;">
          <p><code>VBRAmazonRegionType</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>True</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
[`VBRAmazonS3Connection`](vbramazons3connection.md)

## Examples

::: example
### Example 1. Connecting to Amazon S3 Object Storage [Capacity Extent Scenario]

This example shows how to connect to Amazon S3 object storage. Veeam Backup & Replication will use this connection type to configure a capacity extent of a scale-out backup repository.

```
$account = Get-VBRAmazonAccount -AccessKey "XXXXXXXXXXXXXXX"
$connect = Connect-VBRAmazonS3Service -Account $account -RegionType Global -ServiceType CapacityTier
```

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-VBRAmazonS3Service` cmdlet. Specify the following settings:

   - Set the `$account` variable as the `Account` parameter value.
   - Set the `Global` option for the `RegionType` parameter.
   - Set the `CapacityTier` option for the `ServiceType` parameter.
   - Save the result to the `$connect` variable.

:::

::: example
### Example 2. Connecting to Amazon S3 Object Storage [External Repository Scenario]

This example shows how to connect to Amazon S3 object storage. Veeam Backup & Replication will use this connection type to configure an external repository.

```
$account = Get-VBRAmazonAccount -Id "936edf7c-7cf3-4ddc-9895-c7485ef4bb2c"
$connect = Connect-VBRAmazonS3Service -Account $account -RegionType Global -ServiceType ExternalRepository
```

Perform the following steps:

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

   - Set the `$account` variable as the `Account` parameter value.
   - Set the `Global` option for the `RegionType` parameter.
   - Set the `ExternalRepository` option for the `ServiceType` parameter.
   - Save the result to the `$connect` variable.

:::

::: example
### Example 3. Connecting to Amazon S3 Object Storage [Archive Extent Scenario]

This example shows how to to connect to Amazon S3 object storage. Veeam Backup & Replication will use this connection type to set up an archive extent of a scale-out backup repository.

```
$account = Get-VBRAmazonAccount -Id "936edf7c-7cf3-4ddc-9895-c7485ef4bb2c"
$connect = Connect-VBRAmazonS3Service -Account $account -RegionType Global -ServiceType ArchiveTier
```

Perform the following steps:

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

   - Set the `$account` variable as the `Account` parameter value.
   - Set the `Global` option for the `RegionType` parameter.
   - Set the `ArchiveTier` option for the `ServiceType` parameter.
   - Save the result to the `$connect` variable.

:::

::: example
### Example 4. Connecting to Amazon S3 Object Storage [Object Storage Repository Scenario]

This example shows how to connect to Amazon S3 object storage. Veeam Backup & Replication will use this connection type to configure an object storage repository.

```
$account = Get-VBRAmazonAccount -AccessKey "XXXXXXXXXXXXXXX"
$connect = Connect-VBRAmazonS3Service -Account $account -RegionType Global -ServiceType CapacityTier
```

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-VBRAmazonS3Service` cmdlet. Specify the following settings:

   - Set the `$account` variable as the `Account` parameter value.
   - Set the `Global` option for the `RegionType` parameter.
   - Set the `CapacityTier` option for the `ServiceType` parameter.
   - Save the result to the `$connect` variable.

:::

## Related Commands

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