Set-VBRAmazonS3ExternalRepository

In this article

    Short Description

    Modifies Amazon S3 object storage added as an external repository.

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

    Syntax

    Set-VBRAmazonS3ExternalRepository -ExternalRepository <VBRAmazonS3ExternalRepository> [-Name <string>][-Description <string>] [-DecryptBackups] [-DecryptionKey <VBREncryptionKey>] [-GatewayServer <CHost>][<CommonParameters>]

    Detailed Description

    This cmdlet modifies existing Amazon S3 object storage added as an external repository.

    Set-VBRAmazonS3ExternalRepository Note:

    Mind the following:

    Parameters

    Parameter

    Description

    Type

    Required

    Position

    Accept
    Pipeline
    Input

    ExternalRepository

    Specifies Amazon S3 external repository that you want to modify.

    Accepts the VBRAmazonS3ExternalRepository object. To create this object, run the Get-VBRExternalRepository cmdlet.

    True

    Named

    True (ByValue)

    Name

    Specifies the name of Amazon S3 object storage that you want to add as an external repository.

    String

    False

    Named

    False

    Description

    Specifies the description of Amazon S3 object storage that you want to add as an external repository.

    String

    False

    Named

    False

    DecryptBackups

    Indicates that Veeam Backup & Replication will0 decrypt encrypted backup files created by Cloud Protection Manager.

    SwitchParameter

    False

    Named

    False

    DecryptionKey

    Specifies the password that Veeam Backup & Replication will use to decrypt the backup files.

    Accepts the VBREncryptionKey object. To get this object, run the Add-VBREncryptionKey cmdlet.

    False

    Named

    False

    GatewayServer

    Specifies the gateway server. Veeam Backup & Replication will use this server to access Amazon S3 object storage that is added as an external repository.

    CHost

    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

    Examples

    Modifying Decryption Password for Amazon S3 External Repository

    This example shows how to modify the decryption password for Amazon S3 object storage added as an external repository.

    $repository = Get-VBRExternalRepository -Name "External Repository"

    $securepassword = Read-Host -Prompt "Enter password" -AsSecureString

    $key = Add-VBREncryptionKey -Password $securepassword

    Set-VBRAmazonS3ExternalRepository -ExternalRepository $repository -DecryptBackups -DecryptionKey $key

    1. Run the Get-VBRExternalRepository cmdlet. Specify the Name parameter value. Save the result to the $repository variable.
    2. Run the Read-Host cmdlet. Specify the message that the console will display as a prompt. Specify the AsSecureString parameter. Save the result to the $securepassword variable.
    3. Run the Add-VBREncryptionKey cmdlet. Specify the Password parameter value. Save the result to the $key variable.
    4. Run the Set-VBRAmazonS3ExternalRepository cmdlet. Specify the following settings:
    • Set the $repository variable as the ExternalRepository parameter value.
    • Provide the DecryptBackups parameter.
    • Set the $key variable as the DecryptionKey parameter value.

    Related Commands