Set-VBRS3CompatibleRepositorySecurityOptions - Veeam Backup PowerShell Reference

Set-VBRS3CompatibleRepositorySecurityOptions -Repository <VBRAmazonS3CompatibleRepository> [-AccessControlPolicy <VBRS3CompatibleAccessControlPolicyType>] [-IAMEndpoint <String>] [-STSEndpoint <String>] [<CommonParameters>]

Parameter	Description	Type	Required	Position	Accept Pipeline Input
Repository	Specifies an S3 compatible repository. The cmdlet will modify settings that Veeam Agent uses to access this repository.	Accepts the VBRAmazonS3CompatibleRepository object. To get this object, run the Get-VBRObjectStorageRepository cmdlet.	True	Named	True (ByValue, ByPropertyName)
AccessControlPolicy	Specifies how Veeam Agent accesses S3 compatible repositories: AllowAll — use this option if you want Veeam Agent to access S3 compatible directly using credentials for the S3 compatible bucket. S3CompatibleManaged — use this option if you want Veeam Agent to access S3 compatible repositories directly using secure credentials with a service token. Note: use the IAMEndpoint and STSEndpoint parameters to specify these credentials. VBRManaged — use this option if you want Veeam Agent to access S3 compatible repositories through gateway servers.	VBRS3CompatibleAccessControlPolicyType	False	Named	False
IAMEndpoint	For the direct secure connection with a service token. Specifies an endpoint of your S3 compatible repository. The cmdlet will use this host to connect to this repository.	String	False	Named	False
STSEndpoint	For the direct secure connection with a service token. Specifies the security token of your S3 compatible repository. The cmdlet will use this security token to connect to this repository.	String	False	Named	False

This example shows how to set Veeam Agent to access S3 compatible repositories directly using credentials for the S3 compatible bucket.

$s3repository = Get-VBRObjectStorageRepository -Name "S3 Compatible Repository"

Set-VBRS3CompatibleRepositorySecurityOptions -Repository $s3repository -AccessControlPolicy AllowAll

Perform the following steps:

Run the Get-VBRObjectStorageRepository cmdlet. Specify the Name parameter value. Save the result to the $s3repository variable.
Run the Set-VBRS3CompatibleRepositorySecurityOptions cmdlet. Set the $s3repository variable as the Repository parameter value. Set the AllowAll option for the AccessControlPolicy parameter.

This example shows how to set Veeam Agent to access S3 compatible repositories directly. The cmdlet will connect to the iam.wasabisys.com endpoint and will use secure credentials with the sts.wasabisys.com service token.

$s3repository = Get-VBRObjectStorageRepository -Name "S3 Compatible Repository"

Set-VBRS3CompatibleRepositorySecurityOptions -Repository $s3repository -AccessControlPolicy S3CompatibleManaged -IAMEndpoint "iam.wasabisys.com" -STSEndpoint "sts.wasabisys.com"

Perform the following steps:

Run the Get-VBRObjectStorageRepository cmdlet. Specify the Name parameter value. Save the result to the $s3repository variable.

Run the Set-VBRS3CompatibleRepositorySecurityOptions cmdlet. Specify the following settings:

Set the $s3repository variable as the Repository parameter value.
Set the S3CompatibleManaged option for the AccessControlPolicy parameter.
Specify the IAMEndpoint parameter value.
Specify the STSEndpoint parameter value.

This example shows how to set Veeam Agent to access S3 compatible repositories directly using credentials for the S3 compatible bucket.

$s3repository = Get-VBRObjectStorageRepository -Name "S3 Compatible Repository"

Set-VBRS3CompatibleRepositorySecurityOptions -Repository $s3repository -AccessControlPolicy VBRManaged

Perform the following steps:

Run the Get-VBRObjectStorageRepository cmdlet. Specify the Name parameter value. Save the result to the $s3repository variable.
Run the Set-VBRS3CompatibleRepositorySecurityOptions cmdlet. Set the $s3repository variable as the Repository parameter value. Set the VBRManaged option for the AccessControlPolicy parameter.