Set-VBRCloudProvider

Short Description

Modifies service providers.

Applies to

Platform: VMware, Hyper-V

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

Syntax

Set-VBRCloudProvider -CloudProvider <VBRCloudProvider> [-Address <string>] [-Description <string>] [-Port <int32>] [-Credentials <VBRCloudProviderCredentials>] [-PassThru] [-Appliance <VBRCloudProviderNetworkAppliance[]>] [-VerifyCertificate] [-CertificateThumbprint <string>] [-InstallManagementAgent] [-Force]  [<CommonParameters>]

Detailed Description

This cmdlet modifies settings of service provider added to Veeam Backup & Replication.

Important

The CCredentials object for the Credentials parameter is not accepted any longer. Run the Add-VBRCloudProviderCredentials cmdlet to specify the cloud provider credentials records.

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

Parameter

Description

Type

Required

Position

Accept
Pipeline
Input

CloudProvider

Specifies the service provider you want to modify.

Accepts the VBRCloudProvider object. To get this object, run the Get-VBRCloudProvider cmdlet.

True

Named

True (ByValue,
ByProperty
Name)

Address

Specifies a full DNS name or an IP address of the cloud gateway configured on the service provider side.

String

False

Named

False

Description

Specifies the description of the service provider.

String

False

Named

False

Port

Specifies the port over which the Veeam backup server of the user will communicate with the cloud gateway.

Permitted values: 1 to 65535.

Default: 6180.

Int32

False

Named

False

Credentials

Specifies credentials for the user account registered on the service provider Veeam backup server.

Accepts the VBRCloudProviderCredentials object. To get this object, run the Get-VBRCloudProviderCredentials cmdlet.

False

Named

False

Appliance

Specifies the appliance on the user side that will be used for the partial failover.

Accepts the VBRHvCloudProviderNetworkAppliance[] object. To get this object, run the Set-VBRCloudProviderNetworkAppliance cmdlet.

False

Named

False

VerifyCertificate

Defines if the TLS certificate must be verified by the thumbprints.

Use the CertificateThumbprint parameter to set the thumbprint that will be compared to the TLS certificate thumbprint.

SwitchParameter

False

Named

False

CertificateThumbprint

Specifies the thumbprint that will be compared to the TLS certificate thumbprint.

String

False

Named

False

InstallManagementAgent

Defines that the service provider must manage the Veeam backup server under the Backup as a Service agreement.

The cmdlet will install the Veeam Managed Backup Portal agent on the Veeam backup server.

SwitchParameter

False

Named

False

Force

Defines that the command will skip the certificate verification if the verification fails.

SwitchParameter

False

Named

False

PassThru

Defines that the command will return the output object to the Windows PowerShell console.

SwitchParameter

False

Named

False

WhatIf

Defines that the cmdlet will write a message that describes the effects of running the cmdlet without actually performing any action.

SwitchParameter

False

Named

False

Confirm

Defines that the cmdlet will display a prompt that asks if you want to continue running the command.

SwitchParameter

False

Named

False

<CommonParameters>

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

Output Object

VBRCloudProvider

Examples

Set-VBRCloudProviderExample 1. Enabling TLS Certificate Verification for Service Provider [Using Variable]

Set-VBRCloudProviderExample 2. Setting Cloud Gateway Port [Using Pipeline]

Set-VBRCloudProviderExample 3. Configuring Network Extension Appliance of Service Provider [Using Variable]

Related Commands

Page updated 12/19/2024

Page content applies to build 12.3.1.1139