This is an archive version of the document. To get the most up-to-date information, see the
current version.
Add-VBOAmazonS3ObjectStorageRepository
Adds the Amazon S3 object storage repositories to Veeam Backup for Microsoft 365.
This cmdlet provides parameter sets that allow you to:
- Add an object storage repository of the Amazon S3 Standard storage class.
Add-VBOAmazonS3ObjectStorageRepository -Folder <VBOAmazonS3Folder> -Name <string> [-Description <string>] [-SizeLimit <uint64>] [<CommonParameters>] |
- Add an object storage repository of the Amazon S3 Standard-Infrequent Access storage class.
Add-VBOAmazonS3ObjectStorageRepository -Folder <VBOAmazonS3Folder> -Name <string> [-EnableIAStorageClass <switchparameter>] [-Description <string>] [-SizeLimit <uint64>] [<CommonParameters>] |
- Add an archive object storage repository of the Amazon S3 Glacier or Amazon S3 Glacier Deep Archive storage class.
Add-VBOAmazonS3ObjectStorageRepository -Folder <VBOAmazonS3Folder> -EnableLongTerm <switchparameter> -Name <string> [-EnableGlacierDeepArchive <switchparameter>] [-ArchiverAppliance <VBOAmazonArchiverAppliance>] [-Description <string>] [-SizeLimit <uint64>] [<CommonParameters>] |
This cmdlet adds the Amazon S3 object storage repository to Veeam Backup for Microsoft 365.
Parameter | Description | Type | Required | Position | Accept Pipeline Input | Accept Wildcard Characters |
|---|
Folder | Specifies an Amazon S3 folder. The cmdlet will move backup files into the selected folder. | Accepts the VBOAmazonS3Folder object. To get this object, run the Get-VBOAmazonS3Folder cmdlet. | True | Named | False | False |
Name | Specifies a name of Amazon S3 object storage. The cmdlet will add object storage with this name. | String | True | Named | False | False |
Description | Specifies a description of Amazon S3 object storage. The cmdlet will add object storage with this description. | String | False | Named | False | False |
EnableIAStorageClass | Defines that the cmdlet will enable the Amazon S3 Standard-Infrequent Access storage class for data blocks that are stored in an Amazon S3 object storage. | SwitchParameter | False | Named | False | False |
SizeLimit | Specifies a soft limit in GB for your object storage consumption that can be exceeded temporarily. If the specified limit is exceeded, Veeam Backup for Microsoft 365 will not run a new job. Permitted value: 1024 - 1073741824. Default: 1024 Note: In PowerShell you can specify a soft limit in GB only. | UInt64 | False | Named | False | False |
EnableLongTerm | Defines that the cmdlet will enable adding an archive object storage that will be used as a target for backup copy jobs. Veeam Backup for Microsoft 365 supports Amazon S3 Glacier and Amazon S3 Glacier Deep Archive storage classes for this purpose. | SwitchParameter | True | Named | False | False |
EnableGlacierDeepArchive | Defines that the cmdlet will enable the Amazon S3 Glacier Deep Archive storage class. | SwitchParameter | False | Named | False | False |
ArchiverAppliance | Specifies the Amazon archiver appliance. The cmdlet will use this archiver appliance when transferring backed-up data to an archive object storage. | Accepts the VBOAmazonArchiverAppliance object. To create this object, run the New-VBOAmazonArchiverAppliance 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.
The cmdlet returns the VBOAmazonS3ObjectStorageRepository object that contains settings of the Amazon S3 object storage repository.
This example shows how to add the Amazon S3 object storage repository. $account = Get-VBOAmazonS3Account -Id 26e61916-0257-4a05-8f65-204628d2ed7a $connection = New-VBOAmazonS3ConnectionSettings -Account $account -RegionType Global $bucket = Get-VBOAmazonS3Bucket -AmazonS3ConnectionSettings $connection -RegionId eu-north-1 -Name "BucketName" $folder = Get-VBOAmazonS3Folder -Bucket $bucket -Name "FolderName" Add-VBOAmazonS3ObjectStorageRepository -Folder $folder -Name "Documents" |
Perform the following steps: - Run the Get-VBOAmazonS3Account cmdlet. Specify the Id parameter value. Save the result to the $account variable.
- Run the New-VBOAmazonS3ConnectionSettings cmdlet. Set the $account variable as the Account parameter value. Specify the RegionType parameter value. Save the result to the $connection variable.
- Run the Get-VBOAmazonS3Bucket cmdlet. Set the $connection variable as the AmazonS3ConnectionSettings parameter value. Specify the RegionId parameter value. Specify the Name parameter value. Save the result to the $bucket variable.
- Run the Get-VBOAmazonS3Folder cmdlet. Set the $bucket variable as the Bucket parameter value. Specify the Name parameter value. Save the result to the $folder variable.
- Run the Add-VBOAmazonS3ObjectStorageRepository cmdlet. Set the $folder variable as the Folder parameter value. Specify the Name parameter value.
|
This example shows how to add the Amazon S3 object storage repository with description. $account = Get-VBOAmazonS3Account -Id 26e61916-0257-4a05-8f65-204628d2ed7a $connection = New-VBOAmazonS3ConnectionSettings -Account $account -RegionType Global $bucket = Get-VBOAmazonS3Bucket -AmazonS3ConnectionSettings $connection -RegionId eu-north-1 -Name "BucketName" $folder = Get-VBOAmazonS3Folder -Bucket $bucket -Name "FolderName" Add-VBOAmazonS3ObjectStorageRepository -Folder $folder -Name "Documents" -Description "Created by Administrator" |
Perform the following steps: - Run the Get-VBOAmazonS3Account cmdlet. Specify the Id parameter value. Save the result to the $account variable.
- Run the New-VBOAmazonS3ConnectionSettings cmdlet. Set the $account variable as the Account parameter value. Specify the RegionType parameter value. Save the result to the $connection variable.
- Run the Get-VBOAmazonS3Bucket cmdlet. Set the $connection variable as the AmazonS3ConnectionSettings parameter value. Specify the RegionId parameter value. Specify the Name parameter value. Save the result to the $bucket variable.
- Run the Get-VBOAmazonS3Folder cmdlet. Set the $bucket variable as the Bucket parameter value. Specify the Name parameter value. Save the result to the $folder variable.
- Run the Add-VBOAmazonS3ObjectStorageRepository cmdlet. Specify the following settings:
- Set the $folder variable as the Folder parameter value.
- Specify the Name parameter value.
- Specify the Description parameter value.
|
This example shows how to add an object storage repository of the Amazon S3 Standard-Infrequent Access storage class. The repository will be added with size limits set to 5120 GB. $account = Get-VBOAmazonS3Account -Id 26e61916-0257-4a05-8f65-204628d2ed7a $connection = New-VBOAmazonS3ConnectionSettings -Account $account -RegionType Global $bucket = Get-VBOAmazonS3Bucket -AmazonS3ConnectionSettings $connection -RegionId eu-north-1 -Name "BucketName" $folder = Get-VBOAmazonS3Folder -Bucket $bucket -Name "FolderName" Add-VBOAmazonS3ObjectStorageRepository -Folder $folder -Name "Documents" -EnableIAStorageClass -SizeLimit 5120 |
Perform the following steps: - Run the Get-VBOAmazonS3Account cmdlet. Specify the Id parameter value. Save the result to the $account variable.
- Run the New-VBOAmazonS3ConnectionSettings cmdlet. Set the $account variable as the Account parameter value. Specify the RegionType parameter value. Save the result to the $connection variable.
- Run the Get-VBOAmazonS3Bucket cmdlet. Set the $connection variable as the AmazonS3ConnectionSettings parameter value. Specify the RegionId parameter value. Specify the Name parameter value. Save the result to the $bucket variable.
- Run the Get-VBOAmazonS3Folder cmdlet. Set the $bucket variable as the Bucket parameter value. Specify the Name parameter value. Save the result to the $folder variable.
- Run the Add-VBOAmazonS3ObjectStorageRepository cmdlet. Specify the following settings:
- Set the $folder variable as the Folder parameter value.
- Specify the Name parameter value.
- Provide the EnableIAStorageClass parameter.
- Specify the SizeLimit parameter value.
|
This example shows how to add an archive object storage repository of the Amazon S3 Glacier storage class. $account = Get-VBOAmazonS3Account -Id 26e61916-0257-4a05-8f65-204628d2ed7a $connection = New-VBOAmazonS3ConnectionSettings -Account $account -RegionType Global $bucket = Get-VBOAmazonS3Bucket -AmazonS3ConnectionSettings $connection -RegionId eu-north-1 -Name "BucketName" $folder = Get-VBOAmazonS3Folder -Bucket $bucket -Name "FolderName" Add-VBOAmazonS3ObjectStorageRepository -Folder $folder -EnableLongTerm -Name "Archived Documents" |
Perform the following steps: - Run the Get-VBOAmazonS3Account cmdlet. Specify the Id parameter value. Save the result to the $account variable.
- Run the New-VBOAmazonS3ConnectionSettings cmdlet. Set the $account variable as the Account parameter value. Specify the RegionType parameter value. Save the result to the $connection variable.
- Run the Get-VBOAmazonS3Bucket cmdlet. Set the $connection variable as the AmazonS3ConnectionSettings parameter value. Specify the RegionId parameter value. Specify the Name parameter value. Save the result to the $bucket variable.
- Run the Get-VBOAmazonS3Folder cmdlet. Set the $bucket variable as the Bucket parameter value. Specify the Name parameter value. Save the result to the $folder variable.
- Run the Add-VBOAmazonS3ObjectStorageRepository cmdlet. Specify the following settings:
- Set the $folder variable as the Folder parameter value.
- Provide the EnableLongTerm parameter.
- Specify the Name parameter value.
|
Related Commands
Example 1. Adding Amazon S3 Object Storage Repository