New-VBOAmazonArchiverAppliance

In this article

    Short Description

    Defines the Amazon archiver appliance settings.

    Syntax

    New-VBOAmazonArchiverAppliance [-InstanceType <VBOAmazonInstanceType>] [-Port <int32>] [-VPC <VBOAmazonVpc>] [-Subnet <VBOAmazonSubnet>] [-SecurityGroup <VBOAmazonSecurityGroup>]  [<CommonParameters>]

    Detailed Description

    This cmdlet creates the VBOAmazonArchiverAppliance object. This object defines settings of the Amazon archiver appliance that Veeam Backup for Microsoft 365 will use when transferring backed-up data to an archive object storage.

    Parameters

    Parameter

    Description

    Type

    Required

    Position

    Accept Pipeline Input

    Accept Wildcard Characters

    InstanceType

    Specifies an instance type that the archiver appliance will use.

    For more information on instance types, see this Amazon article.

    Default: m6i.xlarge (4 CPU/16 GB)

    Accepts the VBOAmazonInstanceType object.

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

    False

    Named

    False

    False

    Port

    Specifies the port number. The cmdlet will use this port number to route requests between the archiver appliance and Veeam Backup for Microsoft 365 backup infrastructure components.

    Default: 443

    Int32

    False

    Named

    False

    False

    VPC

    Specifies the Amazon Virtual Private Cloud (Amazon VPC). The cmdlet will launch the target EC2 instance on this Amazon VPC.

    For more information on the Amazon VPC, see this Amazon article.

    Default: Create new

    This value indicates that a new Amazon VPC will be created in a region where a bucket with the specified folder is located when you run the Add-VBOAmazonS3ObjectStorageRepository cmdlet.

    Accepts the VBOAmazonVpc object.

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

    False

    Named

    False

    False

    Subnet

    Specifies the archiver appliance subnet.

    Default: Create new

    This value indicates that a new subnet will be created in a region where a bucket with the specified folder is located when you run the Add-VBOAmazonS3ObjectStorageRepository cmdlet.

    Accepts the VBOAmazonSubnet object.

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

    False

    Named

    False

    False

    SecurityGroup

    Specifies a security group that will be associated with the archiver appliance.

    For more information on security groups for Amazon VPC, see this Amazon article.

    Default: Create new

    This value indicates that a new security group will be created in a region where a bucket with the specified folder is located when you run the Add-VBOAmazonS3ObjectStorageRepository cmdlet.

    Accepts the VBOAmazonSecurityGroup object.

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

    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 VBOAmazonArchiverAppliance object that contains the Amazon archiver appliance settings.

    Examples

    New-VBOAmazonArchiverApplianceExample 1. Creating Amazon Archiver Appliance

    This example shows how to define the Amazon archiver appliance settings.

    $S3account = Get-VBOAmazonS3Account -AccessKey "?Iqws8NewidZydk"

    $S3connection = New-VBOAmazonS3ConnectionSettings -Account $S3account -RegionType Global

    $inst = Get-VBOAmazonInstanceType -AmazonS3ConnectionSettings $S3connection -RegionId eu-central-1 -Name m6i.2xlarge

    $VPC = Get-VBOAmazonVPC -AmazonS3ConnectionSettings $S3connection -RegionId eu-central-1 -Name "VPCName"

    $subnet = Get-VBOAmazonSubnet -VPC $VPC -Name "SubnetName"

    $sgroup = Get-VBOAmazonSecurityGroup -VPC $VPC -Name "SecurityGroupName"

    New-VBOAmazonArchiverAppliance -InstanceType $inst -VPC $VPC -Subnet $subnet -SecurityGroup $sgroup -Port 80

    Perform the following steps:

    1. Run the Get-VBOAmazonS3Account cmdlet. Specify the AccessKey parameter value.  Save the result to the $S3account variable.
    2. Run the New-VBOAmazonS3ConnectionSettings cmdlet. Set the $S3account variable as the Account parameter value. Specify the RegionType parameter value. Save the result to the $S3connection variable.
    3. Run the Get-VBOAmazonInstanceType cmdlet. Set the $S3connection variable as the AmazonS3ConnectionSettings parameter value. Specify the RegionId parameter value. Specify the Name parameter value. Save the result to the $inst variable.
    4. Run the Get-VBOAmazonVPC cmdlet. Set the $S3connection variable as the AmazonS3ConnectionSettings parameter value. Specify the RegionId parameter value. Specify the Name parameter value. Save the result to the $VPC variable.
    5. Run the Get-VBOAmazonSubnet cmdlet. Set the $VPC variable as the VPC parameter value. Specify the Name parameter value. Save the result to the $subnet variable.
    6. Run the Get-VBOAmazonSecurityGroup cmdlet. Set the $VPC variable as the VPC parameter value. Specify the Name parameter value. Save the result to the $sgroup variable.
    7. Run the New-VBOAmazonArchiverAppliance cmdlet. Specify the following settings:
    • Set the $inst variable as the InstanceType parameter value.
    • Set the $VPC variable as the VPC parameter value.
    • Set the $subnet variable as the Subnet parameter value.
    • Set the $sgroup variable as the SecurityGroup parameter value.
    • Specify the Port parameter value.

    Related Commands