New-VBOAmazonS3CompatibleConnectionSettings

In this article

    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 an 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