---
title: "New-VBOAmazonS3ServiceConnectionSettings"
description: "This cmdlet creates the VBOAmazonS3ConnectionSettings object. This object contains connection settings to Amazon S3 object storage repository."
canonical: "https://helpcenter.veeam.com/docs/vbo365/powershell/new-vboamazons3serviceconnectionsettings.html"
breadcrumb: "PowerShell Reference > Veeam Backup for Microsoft 365 PowerShell Reference > Backup Infrastructure > Amazon Storage Settings > Amazon S3 Connection Settings > New-VBOAmazonS3ServiceConnectionSettings"
dateModified: "2026-08-21"
---

# New-VBOAmazonS3ServiceConnectionSettings

## Short Description
Defines connection settings to Amazon S3 object storage repository.

::: note

In Veeam Backup for Microsoft 365 8, this cmdlet became deprecated. Use the [`New-VBOAmazonS3ConnectionSettings`](new-vboamazons3connectionsettings.md) cmdlet to define connection settings to Amazon S3 object storage repository.

:::

## Syntax
```
New-VBOAmazonS3ServiceConnectionSettings -Account <VBOAmazonS3Account> -RegionType <VBOAmazonS3RegionType> [<CommonParameters>]
```

## Detailed Description
This cmdlet creates the [`VBOAmazonS3ConnectionSettings`](vboamazons3connectionsettings.md) object. This object contains connection settings to Amazon S3 object storage repository.

## 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 Amazon S3 storage account credentials. The cmdlet will use these storage account credentials to connect to Amazon S3 object storage repository.</p><p>Accepts the <a href="vboamazons3account.md"><code>VBOAmazonS3Account</code></a> object.</p><p>To get this object, run the <a href="get-vboamazons3account.md"><code>Get-VBOAmazonS3Account</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vboamazons3account.md"><code>VBOAmazonS3Account</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">RegionType</span></p>
        </td>
        <td>
          <p>Specifies the region type for Amazon S3 object storage repository. The cmdlet will connect to the selected region type and will set up a connection with Amazon S3 object storage repository. You can select the following region type:</p><ul><li><code>Global</code></li><li><code>USGovernment</code></li><li><code>China</code></li></ul>
        </td>
        <td style="width:10%;">
          <p><code>VBOAmazonS3RegionType</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 the [About Common Parameters](http://go.microsoft.com/fwlink/p/?LinkID=113216) section of Microsoft Learn.

## Output Object
The cmdlet returns the [`VBOAmazonS3ConnectionSettings`](vboamazons3connectionsettings.md) object that defines connection settings to Amazon S3 object storage repository.

## Examples

::: example
### Example 1: Connecting to Amazon S3 Object Storage of Global Region Type

This example shows how to connect to Amazon S3 object storage repository of the *Global* region type.

```
$account = Get-VBOAmazonS3Account -Id 26e61916-0257-4a05-8f65-204628d2ed7a
New-VBOAmazonS3ServiceConnectionSettings -Account $account -RegionType Global
```

Perform the following steps:

1. Run the [`Get-VBOAmazonS3Account`](get-vboamazons3account.md) cmdlet. Specify the `Id` parameter value. Save the result to the `$account` variable.
2. Run the `New-VBOAmazonS3ServiceConnectionSettings` cmdlet. Set the `$account` variable as the `Account` parameter value. Specify the `RegionType` parameter value.

:::

::: example
### Example 2: Connecting to Amazon S3 Object Storage of US Government Region Type

This example shows how to connect to Amazon S3 object storage repository of the *US Government* region type.

```
$account = Get-VBOAmazonS3Account -Id d1fc1171-3206-429f-9563-51b9af8df0ac
New-VBOAmazonS3ServiceConnectionSettings -Account $account -RegionType USGovernment
```

Perform the following steps:

1. Run the [`Get-VBOAmazonS3Account`](get-vboamazons3account.md) cmdlet. Specify the `Id` parameter value. Save the result to the `$account` variable.
2. Run the `New-VBOAmazonS3ServiceConnectionSettings` cmdlet. Set the `$account` variable as the `Account` parameter value. Specify the `RegionType` parameter value.

:::

::: example
### Example 3: Connecting to Amazon S3 Object Storage of China Region Type

This example shows how to connect to Amazon S3 object storage repository of the *China* region type.

```
$account = Get-VBOAmazonS3Account -Id f7e0a65d-1042-4ab0-bc73-699acbb5cb79
New-VBOAmazonS3ServiceConnectionSettings -Account $account -RegionType China
```

Perform the following steps:

1. Run the [`Get-VBOAmazonS3Account`](get-vboamazons3account.md) cmdlet. Specify the `Id` parameter value. Save the result to the `$account` variable.
2. Run the `New-VBOAmazonS3ServiceConnectionSettings` cmdlet. Set the `$account` variable as the `Account` parameter value. Specify the `RegionType` parameter value.

:::

## Related Commands

[`Get-VBOAmazonS3Account`](get-vboamazons3account.md)