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 VBOAmazonS3CompatibleServiceConnectionSettings 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 this storage account credentials to connect to Amazon S3 object storage.

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

    True

    Named

    False

     

    ServicePoint

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

    String

    True

    Named

    False

     

    CustomRegionId

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

    String

    False

    Named

    False

     

    TrustServerCertificate

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

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

    SwitchParameter

    False

    Named

    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 VBOAmazonS3CompatibleServiceConnectionSettings object that defines connection settings to Amazon S3 object storage.

    Examples

    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 RegionType parameter value.
    • Specify the ServicePoint parameter value.

    Related Commands

    Get-VBOAmazonS3CompatibleAccount