New-VBOAmazonS3CompatibleConnectionSettings

Short Description

Defines connection settings to S3 Compatible object storage.

Syntax

New-VBOAmazonS3CompatibleConnectionSettings -Account <VBOAmazonS3CompatibleAccount> -ServicePoint <String> [-CustomRegionId <String>] [-TrustServerCertificate]  [<CommonParameters>]

Detailed Description

This cmdlet creates the VBOAmazonS3CompatibleConnectionSettings object. This object contains connection settings to S3 Compatible object storage.

Parameters

Parameter

Description

Type

Required

Position

Accept Pipeline Input

Accept Wildcard Characters

Account

Specifies S3 Compatible storage account credentials. The cmdlet will use these storage account credentials to connect to S3 Compatible object storage.

Accepts the VBOAmazonS3CompatibleAccount object.

To get this object, run the Get-VBOAmazonS3CompatibleAccount cmdlet.

True

Named

False

False

ServicePoint

Specifies the S3 Compatible endpoint address. The cmdlet will use this endpoint address to connect to S3 Compatible object storage.

String

True

Named

False

False

CustomRegionId

Specifies an Amazon S3 region where your S3 Compatible object storage is located.

String

False

Named

False

False

TrustServerCertificate

Defines that Veeam Backup for Microsoft 365 will trust Amazon S3 Compatible self-signed certificates.

If you omit this parameter, Veeam Backup for Microsoft 365 will not trust Amazon S3 Compatible self-signed certificates.

SwitchParameter

False

Named

False

False

<CommonParameters>

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see the About CommonParameters section of Microsoft Docs.

Output Object

The cmdlet returns the VBOAmazonS3CompatibleConnectionSettings object that defines connection settings to S3 Compatible object storage.

Examples

New-VBOAmazonS3CompatibleConnectionSettingsExample 1. Connecting to S3 Compatible Storage

This example shows how to connect to S3 Compatible storage.

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

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

Perform the following steps:

  1. Run the Get-VBOAmazonS3CompatibleAccount cmdlet. Specify the Id parameter value. Save the result to the $account variable.
  2. Run the New-VBOAmazonS3CompatibleConnectionSettings cmdlet. Specify the following settings:
  • Set the $account variable as the Account parameter value.
  • Specify the ServicePoint parameter value.

Related Commands

Get-VBOAmazonS3CompatibleAccount