Add-VBRAmazonS3GlacierRepository

In this article

    Short Description

    Adds Amazon S3 Glacier archive storage repository to the backup infrastructure.

    Product Edition: Standard, Enterprise, Enterprise Plus, Veeam Universal License

    Syntax

    Add-VBRAmazonS3GlacierRepository -Connection <VBRAmazonS3Connection> -AmazonS3Folder <VBRAmazonS3Folder> -AmazonProxySpec <VBRAmazonEC2ProxyAppliance> [-Name <string>] [-Description <string>] [-UseDeepArchive] [-EnableBackupImmutability] [<CommonParameters>]

    Detailed Description

    This cmdlet adds Amazon S3 Glacier archive storage repository to the backup infrastructure.

    Parameters

    Parameter

    Description

    Type

    Required

    Position

    Accept
    Pipeline
    Input

    Connection

    Specifies an active session with an Amazon S3 Glacier object storage that you want to add as an archive repository.

    Accepts the VBRAmazonS3Connection object. To get this object, run the Connect-VBRAmazonS3Service cmdlet and set the ArchiveTier property as the ServiceType parameter value.

    True

    Named

    False

    AmazonS3Folder

    Specifies an Amazon S3 folder. Veeam Backup & Replication will move backup files into this folder.

    Accepts the VBRAmazonS3Folder object. To create this object, run the New-VBRAmazonS3Folder cmdlet.

    True

    Named

    True (ByValue)

    AmazonProxySpec

    Specifies a proxy appliance for transferring the data from Amazon S3 to Amazon S3 Glacier object storage.

    Accepts the VBRAmazonEC2ProxyAppliance object. To create this object, run the New-VBRAmazonEC2ProxyAppliance cmdlet.

    True

    Named

    True (ByPropertyName)

    Name

    Specifies a name of an Amazon S3 Glacier object storage. The cmdlet will add object storage with this name.

    String

    False

    Named

    False

    Description

    Specifies a description of an Amazon S3 Glacier object storage. The cmdlet will add object storage with this description.

    String

    False

    Named

    False

    UseDeepArchive

    Defines that the cmdlet will apply the Glacier Deep Archive for backups feature. If you provide this parameter, the cmdlet will assign the Glacier Deep Archive storage class to the backups.

    Default: False

    SwitchParameter

    False

    Named

    False

    EnableBackupImmutability

    Enables the immutability option.

    Default: False

    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

    This cmdlet returns VBRAmazonS3GlacierRepository object that defines the Amazon Glacier archive storage repository settings.

    Examples

    Adding Amazon S3 Glacier Repository

    This example shows how to add Amazon S3 Glacier object storage as a backup repository to the backup infrastructure.

    $account = Add-VBRAmazonAccount -AccessKey "XXXXXXXXXXXXXXXXXXX" -SecretKey "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"

    $connection = Connect-VBRAmazonS3Service -Account $account -RegionType Global -ServiceType archiveTier

    $bucket = Get-VBRAmazonS3Bucket -Connection $connection -Name "connect"

    $folder = Get-VBRAmazonS3Folder -Connection $connection -Bucket $bucket -Name "veeam"

    $region = Get-VBRAmazonEC2Region -Account $account -RegionType Global -Name "ap-northeast-1"

    $instance = Get-VBRAmazonEC2InstanceType -Region $region -Name "al.xlarge"

    $vpc = Get-VBRAmazonEC2VPC -Region $region

    $sgroup = Get-VBRAmazonEC2SecurityGroup -VPC $vpc -Name "veeamvpc"

    $subnet = Get-VBRAmazonEC2Subnet -VPC $vpc -Name "veeamsubnet"

    $proxy = New-VBRAmazonEC2ProxyAppliance -InstanceType $instance -Subnet $subnet -SecurityGroup $sgroup -RedirectorPort 443

    Add-VBRAmazonS3GlacierRepository -Connection $connection -AmazonS3Folder $folder -AmazonProxySpec $proxy -Name Repository09

    Perform the following steps:

    1. Specify Amazon connection settings:
    1. Run the Get-VBRAmazonAccount cmdlet. Specify the AccessKey and SecretKey parameter values. Save the result to the $account variable.
    1. Run the Connect-VBRAmazonS3Service cmdlet. Specify the Account, RegionType and ServiceType parameter values. Save the result to the $connection variable.
    1. Specify object storage settings:
    1. Run the Get-VBRAmazonS3Bucket cmdlet. Specify the Connection and Name parameter values. Save the result to the $bucket variable.
    2. Run the Get-VBRAmazonS3Folder cmdlet. Specify the Connection, Bucket and Name parameter values. Save the result to the $folder variable.
    1. Define the Amazon proxy settings:
    1. Run the Get-VBRAmazonS3Region cmdlet. Specify the Account, RegionType and Name parameter values. Save the result to the $region variable.
    2. Run the Get-VBRAmazonEC2InstanceType cmdlet. Specify the Region and Name parameter values. Save the result to the $instance variable.
    3. Run the Get-VBRAmazonEC2VPC cmdlet. Specify the Region parameter value. Save the result to the $vpc variable.
    4. Run the Get-VBRAmazonEC2SecurityGroup cmdlet. Specify the VPC and Name parameter values. Save the result to the $sgroup variable.
    5. Run the Get-VBRAmazonEC2Subnet cmdlet. Specify the VPC and Name parameter values. Save the result to $subnet variable.
    6. Run the New-VBRAmazonEC2ProxyAppliance cmdlet. Specify the InstanceType, Subnet, SecurityGroup and RedirectorPort parameter values. Save the result to $proxy variable.
    1. Run the Add-VBRAmazonS3GlacierRepository cmdlet. Specify the following settings:
    • Set the $connection variable as the Connection parameter value.
    • Set the $folder variable as the Folder parameter value.
    • Set the $proxy variable as the Proxy parameter value.
    • Specify the Name parameter value.

    Related Commands