Set-VBRCloudGatewayPool

Short Description

Modifies cloud gateway pools.

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

Syntax

Set-VBRCloudGatewayPool -CloudGatewayPool <VBRCloudGatewayPool> [-Name <String>] [-Description <String>]

[-CloudGateway <VBRCloudGateway[]>] [-Force] [<CommonParameters>]

Detailed Description

This cmdlet modifies cloud gateway pools.

Note

To modify settings, specify new values for the necessary parameters. The cmdlet will overwrite the previous parameter values with new values. The parameters that you omit will remain unchanged.

Parameters

Parameters

Parameter

Description

Type

Required

Position

Accept Pipeline Input

CloudGateway

Specifies cloud gateways. The cmdlet will add these cloud gateways to the cloud gateway pool.

Note: The cmdlet will overwrite the existing cloud gateway pools with the new ones.

Accepts the VBRCloudGateway[] object. To get this object, run the Get-VBRCloudGatewayReturns cloud gateways. cmdlet.

VBRCloudGateway[]

False

Named

False

CloudGatewayPool

Specifies the cloud gateway pool that you want to modify.

Accepts the VBRCloudGatewayPool object. To get this object, run the Get-VBRCloudGatewayPoolReturns cloud gateway pools. cmdlet.

VBRCloudGatewayPool

True

Named

True (ByValue)

Description

Specifies the description that you want to add to the existing cloud gateway pool. The cmdlet will change the description of the selected cloud gateway pool.

String

False

Named

False

Force

Defines that the cmdlet will add all available gateways to cloud gateway pools without warning.

SwitchParameter

False

Named

False

Name

Specifies the name that you want to assign to the existing cloud gateway pool. The cmdlet will change the name of the selected cloud gateway pool.

String

False

Named

False

<CommonParameters>

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see Microsoft Docs.

Output Object

VBRCloudGatewayPool

Examples

Modifying Name of Cloud Gateway Pool

This example shows how to modify the name of a cloud gateway pool.

$pool = Get-VBRCloudGatewayPool -Name "New Cloud Pool"

Set-VBRCloudGatewayPool -CloudGatewayPool $pool -Name "Silver Cloud Pool"

Perform the following steps:

  1. Run the Get-VBRCloudGatewayPoolReturns cloud gateway pools. cmdlet. Specify the Name parameter value. Save the result to the $pool variable.
  2. Run the Set-VBRCloudGatewayPool cmdlet. Set the $pool variable as the CloudGatewayPool parameter value. Specify the Name parameter value.

Get-VBRCloudGatewayPoolReturns cloud gateway pools.

Page updated 2026-08-19

Page content applies to build 13.1.1.18