---
title: "Get-VBOAmazonS3Folder"
description: "This cmdlet returns the VBOAmazonS3Folder object that contains an array of Amazon S3 folders. You can get the array of the folders for the following types of Amazon S3 object storage repositories: Amazon S3 S3 Compatible"
canonical: "https://helpcenter.veeam.com/docs/vbo365/powershell/get-vboamazons3folder.html"
breadcrumb: "PowerShell Reference > Veeam Backup for Microsoft 365 PowerShell Reference > Backup Infrastructure > Amazon Storage Settings > Storage Buckets and Folders > Get-VBOAmazonS3Folder"
dateModified: "2026-08-21"
---

# Get-VBOAmazonS3Folder

## Short Description
Returns Amazon S3 folders.

## Syntax
```
Get-VBOAmazonS3Folder -Bucket <VBOAmazonS3Bucket> [-Name <String>] [<CommonParameters>]
```

## Detailed Description
This cmdlet returns the [`VBOAmazonS3Folder`](vboamazons3folder.md) object that contains an array of Amazon S3 folders. You can get the array of the folders for the following types of Amazon S3 object storage repositories:

- Amazon S3
- S3 Compatible

## 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">Bucket</span></p>
        </td>
        <td>
          <p>Specifies an Amazon S3 bucket. The cmdlet will return an array of the folders added to this bucket.</p><p>Accepts the <a href="vboamazons3bucket.md"><code>VBOAmazonS3Bucket</code></a> object.</p><p>To get this object, run the <a href="get-vboamazons3bucket.md"><code>Get-VBOAmazonS3Bucket</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vboamazons3bucket.md"><code>VBOAmazonS3Bucket</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">Name</span></p>
        </td>
        <td>
          <p>Specifies a name of the Amazon S3 folder. The cmdlet will return the folder with this name.</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 the [About Common Parameters](http://go.microsoft.com/fwlink/p/?LinkID=113216) section of Microsoft Learn.

## Output Object
The cmdlet returns the [`VBOAmazonS3Folder`](vboamazons3folder.md) object that contains an array of Amazon S3 folders.

## Examples

::: example
### Example 1: Getting Amazon S3 Folders

This example shows how to get Amazon S3 folders.

```
$account = Get-VBOAmazonS3Account -Id 26e61916-0257-4a05-8f65-204628d2ed7a
$connection = New-VBOAmazonS3ConnectionSettings -Account $account -RegionType Global
$bucket = Get-VBOAmazonS3Bucket -AmazonS3ConnectionSettings $connection -RegionId eu-north-1
Get-VBOAmazonS3Folder -Bucket $bucket -Name "Reports 09"
```

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-VBOAmazonS3ConnectionSettings`](new-vboamazons3connectionsettings.md) cmdlet. Set the `$account` variable as the `Account` parameter value. Specify the necessary parameters. Save the result to the `$connection` variable.
3. Run the [`Get-VBOAmazonS3Bucket`](get-vboamazons3bucket.md) cmdlet. Set the `$connection` variable as the `AmazonS3ConnectionSettings` parameter value. Specify the `RegionId` parameter value. Save the result to the `$bucket` variable.
4. Run the `Get-VBOAmazonS3Folder` cmdlet. Set the `$bucket` variable as the `Bucket` parameter value. Specify the `Name` parameter value.

:::

::: example
### Example 2: Getting S3 Compatible Folders

This example shows how to get S3 Compatible folders.

```
$account = Get-VBOAmazonS3CompatibleAccount -Id 26e61916-0257-4a05-8f65-204628d2ed7a
$connection = New-VBOAmazonS3CompatibleConnectionSettings -Account $account -ServicePoint "172.17.186.13:9000"
$bucket = Get-VBOAmazonS3Bucket -AmazonS3CompatibleConnectionSettings $connection
Get-VBOAmazonS3Folder -Bucket $bucket -Name "Reports 10"
```

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` cmdlet. Set the `$bucket` variable as the `Bucket` parameter value. Specify the `Name` parameter value.

:::

## Related Commands

- [`Get-VBOAmazonS3Account`](get-vboamazons3account.md)
- [`Get-VBOAmazonS3CompatibleAccount`](get-vboamazons3compatibleaccount.md)
- [`New-VBOAmazonS3ConnectionSettings`](new-vboamazons3connectionsettings.md)
- [`New-VBOAmazonS3CompatibleConnectionSettings`](new-vboamazons3compatibleconnectionsettings.md)
- [`Get-VBOAmazonS3Bucket`](get-vboamazons3bucket.md)