Get-VBOAmazonS3Bucket

Short Description

Returns Amazon S3 buckets.

Syntax

This cmdlet provides the following parameter sets:

AmazonS3AwsParameterSet

Get-VBOAmazonS3Bucket -AmazonS3ConnectionSettings <VBOAmazonS3ConnectionSettings> [-Name <String>]

[-RegionId <String>] [<CommonParameters>]
AmazonS3CompatibleParameterSet

Get-VBOAmazonS3Bucket -AmazonS3CompatibleConnectionSettings <VBOAmazonS3CompatibleConnectionSettings>

[-Name <String>] [<CommonParameters>]

Detailed Description

This cmdlet returns the VBOAmazonS3Bucket object that contains an array of Amazon buckets for the following Amazon services:

Amazon S3
S3 Compatible

Parameters

Parameters
Parameter	Description	Type	Required	Position	Accept Pipeline Input
AmazonS3CompatibleConnectionSettings	Specifies an active session with S3 Compatible object storage repository. The cmdlet will return an array of Amazon S3 buckets for this S3 Compatible object storage repository. Accepts the `VBOAmazonS3CompatibleConnectionSettings` object. To create this object, run the `New-VBOAmazonS3CompatibleConnectionSettings` cmdlet.	`VBOAmazonS3CompatibleConnectionSettings`	True	Named	False
AmazonS3ConnectionSettings	Specifies an active session with Amazon S3 object storage repository. The cmdlet will return an array of Amazon S3 buckets for this Amazon S3 object storage repository. Accepts the `VBOAmazonS3ConnectionSettings` object. To create this object, run the `New-VBOAmazonS3ConnectionSettings` cmdlet.	`VBOAmazonS3ConnectionSettings`	True	Named	False
Name	Specifies a name of the Amazon S3 bucket. The cmdlet will return the bucket with this name.	`String`	False	Named	False
RegionId	Specifies a region of Amazon S3 object storage repository. For example, us-east-1. For more information, see this Amazon article.	`String`	False	Named	False

<CommonParameters>

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see the About Common Parameters section of Microsoft Learn.

Output Object

The cmdlet returns the VBOAmazonS3Bucket object that contains an array of Amazon S3 buckets.

Examples

Get-VBOAmazonS3Bucket Example 1: Getting Amazon S3 Buckets

This example shows how to get Amazon S3 buckets.

$account = Get-VBOAmazonS3Account -Id 26e61916-0257-4a05-8f65-204628d2ed7a

$connection = New-VBOAmazonS3ConnectionSettings -Account $account -RegionType Global

Get-VBOAmazonS3Bucket -AmazonS3ConnectionSettings $connection -RegionId eu-north-1

Perform the following steps:

Run the Get-VBOAmazonS3Account cmdlet. Specify the Id parameter value. Save the result to the $account variable.
Run the New-VBOAmazonS3ConnectionSettings cmdlet. Set the $account variable as the Account parameter value. Specify the RegionType parameter value. Save the result to the $connection variable.
Run the Get-VBOAmazonS3Bucket cmdlet. Set the $connection variable as the AmazonS3ConnectionSettings parameter value. Specify the RegionId parameter value.

Get-VBOAmazonS3Bucket Example 2: Getting S3 Compatible Buckets

This example shows how to get S3 Compatible buckets.

$account = Get-VBOAmazonS3CompatibleAccount -Id 26e61916-0257-4a05-8f65-204628d2ed7a

$connection = New-VBOAmazonS3CompatibleConnectionSettings -Account $account -ServicePoint "172.17.186.13:9000"

Get-VBOAmazonS3Bucket -AmazonS3CompatibleConnectionSettings $connection

Perform the following steps:

Run the Get-VBOAmazonS3CompatibleAccount cmdlet. Specify the Id parameter value. Save the result to the $account variable.
Run the New-VBOAmazonS3CompatibleConnectionSettings cmdlet. Specify the necessary parameters. Save the result to the $connection variable.
Run the Get-VBOAmazonS3Bucket cmdlet. Set the $connection variable as the AmazonS3CompatibleConnectionSettings parameter value.