---
title: "Set-VBRCloudProvider"
description: "This cmdlet modifies settings of service provider added to Veeam Backup & Replication. The CCredentials object for the Credentials parameter is not accepted any longer."
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/set-vbrcloudprovider.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Veeam Cloud Connect > Veeam Cloud Connect Service Provider > Set-VBRCloudProvider"
dateModified: "2026-08-19"
---

# Set-VBRCloudProvider

## Short Description
Modifies service providers.

**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] [-RestoreAccessLevel <VBRVccRestoreAccessLevel>] [<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`](add-vbrcloudprovidercredentials.md) 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

<table style="width:100%;" class="Blue_Table">
      <tr style="vertical-align:top">
        <th style="width:20%;">
          <p>Parameter</p>
        </th>
        <th style="width:20%;">
          <p>Description</p>
        </th>
        <th style="width:20%;">
          <p>Type</p>
        </th>
        <th style="width:10%;">
          <p>Required</p>
        </th>
        <th style="width:10%;">
          <p>Position</p>
        </th>
        <th style="width:10%;">
          <p>Accept Pipeline Input</p>
        </th>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Address</span></p>
        </td>
        <td>
          <p>Specifies a full DNS name or an IP address of the cloud gateway configured on the service provider side.</p>
        </td>
        <td style="width:10%;">
          <p><code>String</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Appliance</span></p>
        </td>
        <td>
          <p>Specifies the appliance on the user side that will be used for the partial failover.</p><p>Accepts the <a href="vbrhvcloudprovidernetworkappliance.md"><code>VBRHvCloudProviderNetworkAppliance[]</code></a> object. To get this object, run the <a href="set-vbrcloudprovidernetworkappliance.md"><code>Set-VBRCloudProviderNetworkAppliance</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>VBRCloudProviderNetworkAppliance[]</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">CertificateThumbprint</span></p>
        </td>
        <td>
          <p>Specifies the thumbprint that will be compared to the TLS certificate thumbprint.</p>
        </td>
        <td style="width:10%;">
          <p><code>String</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">CloudProvider</span></p>
        </td>
        <td>
          <p>Specifies the service provider you want to modify.</p><p>Accepts the <a href="vbrcloudprovider.md"><code>VBRCloudProvider</code></a> object. To get this object, run the <a href="get-vbrcloudprovider.md"><code>Get-VBRCloudProvider</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbrcloudprovider.md"><code>VBRCloudProvider</code></a></p>
        </td>
        <td style="width:10%;">
          <p>True</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>True (ByPropertyName, ByValue)</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Credentials</span></p>
        </td>
        <td>
          <p>Specifies credentials for the user account registered on the service provider Veeam backup server.</p><p>Accepts the <code>VBRCloudProviderCredentials</code> object. To get this object, run the <a href="get-vbrcloudprovidercredentials.md"><code>Get-VBRCloudProviderCredentials</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>VBRCloudProviderCredentials</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Description</span></p>
        </td>
        <td>
          <p>Specifies the description of the service provider.</p>
        </td>
        <td style="width:10%;">
          <p><code>String</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Force</span></p>
        </td>
        <td>
          <p>Defines that the command will skip the certificate verification if the verification fails.</p>
        </td>
        <td style="width:10%;">
          <p><code>SwitchParameter</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">InstallManagementAgent</span></p>
        </td>
        <td>
          <p>Defines that the service provider must manage the Veeam backup server under the Backup as a Service agreement.</p><p>The cmdlet will install the Veeam Managed Backup Portal agent on the Veeam backup server.</p>
        </td>
        <td style="width:10%;">
          <p><code>SwitchParameter</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">PassThru</span></p>
        </td>
        <td>
          <p>Defines that the command will return the output object to the Windows PowerShell console.</p>
        </td>
        <td style="width:10%;">
          <p><code>SwitchParameter</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Port</span></p>
        </td>
        <td>
          <p>Specifies the port over which the Veeam backup server of the user will communicate with the cloud gateway.</p><p>Permitted values: <code>1</code> to <code>65535</code>.</p><p>Default: <code>6180</code>.</p>
        </td>
        <td style="width:10%;">
          <p><code>Int32</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">RestoreAccessLevel</span></p>
        </td>
        <td>
          <p>Defines the access level according to which the service provider can restore backups stored on cloud repositories:</p><ul><li><code>None</code>: the service provider cannot restore backups.</li><li><code>UnencryptedBackups</code>: the service provider can restore only  backups created without encryption.</li><li><code>AllBackups</code>: the service provider can restore any backups.</li></ul><p>Default: <code>None</code>.</p><p><strong>Note</strong>: You cannot decrease the access level given to the service provider. The <code>AllBackups</code> access level is permanent and cannot be revoked.</p>
        </td>
        <td style="width:10%;">
          <p><code>VBRVccRestoreAccessLevel</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">VerifyCertificate</span></p>
        </td>
        <td>
          <p>Defines if the TLS certificate must be verified by the thumbprints.</p><p>Use the <code>CertificateThumbprint</code> parameter to set the thumbprint that will be compared to the TLS certificate thumbprint.</p>
        </td>
        <td style="width:10%;">
          <p><code>SwitchParameter</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
    </table>

`<CommonParameters>`

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see [ Microsoft Docs](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_commonparameters?view=powershell-7).

## Output Object
[`VBRCloudProvider`](vbrcloudprovider.md)

## Examples

::: example
### Example 1. Enabling TLS Certificate Verification for Service Provider [Using Variable]

This example shows how to enable the TLS certificate verification for a service provider.

```
$CloudProvider = Get-VBRCloudProvider -Name "104.45.95.227"
Set-VBRCloudProvider -CloudProvider $CloudProvider -VerifyCertificate -CertificateThumbprint "‎e6 c0 e5 1a db 73 0c 13 b3 c3 74 d4 ee 93 ab d0 08 3f 7a a8"
```

Perform the following steps:

1. Run the [`Get-VBRCloudProvider`](get-vbrcloudprovider.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$CloudProvider` variable.
2. Run the `Set-VBRCloudProvider` cmdlet. Set the `$CloudProvider` variable as the `CloudProvider` parameter value. Provide the `VerifyCertificate` parameter. Specify the `CertificateThumbprint` parameter value.

:::

::: example
### Example 2. Setting Cloud Gateway Port [Using Pipeline]

This example shows how to set the cloud gateway port to the default value.

```
Get-VBRCloudProvider -Name "104.45.95.227" | Set-VBRCloudProvider -Port 6180
```

Perform the following steps:

1. Run the [`Get-VBRCloudProvider`](get-vbrcloudprovider.md) cmdlet. Specify the `Name` parameter value.
2. Pipe the cmdlet output to the `Set-VBRCloudProvider` cmdlet. Specify the `Port` parameter value.

:::

::: example
### Example 3. Configuring Network Extension Appliance of Service Provider [Using Variable]

This example shows how to edit configuration of the network extension appliance configured for the service provider.

```
$provider = Get-VBRCloudProvider -Name "104.45.95.227"
$viAppl = Get-VBRCloudProviderNetworkAppliance -CloudProvider $provider
$newFolder = "C:\Users\admin"
$newAppliance = Set-VBRCloudProviderNetworkAppliance -NetworkAppliance $hvAppl -Folder $newFolder
$CloudProvider = Get-VBRCloudProvider -Name "104.45.95.227"
Set-VBRCloudProvider -CloudProvider $CloudProvider -Appliance $newAppliance
```

Perform the following steps:

1. Modify the network extension appliance:

   - Run the [`Get-VBRCloudProvider`](get-vbrcloudprovider.md) cmdlet. Specify the `Name` parameter values. Save the result to the `$provider` variable.
   - Run the [`Get-VBRCloudProviderNetworkAppliance`](get-vbrcloudprovidernetworkappliance.md) cmdlet. Set the `$provider` variable as the `CloudProvider` parameter value. Save the result to the `$viAppl` variable.
   - Assign the `$newFolder` variable the `C:\Users\admin` value.
   - Run the [`Set-VBRCloudProviderNetworkAppliance`](set-vbrcloudprovidernetworkappliance.md) cmdlet for instructions. Specify the `NetworkAppliance` and `Folder` parameter values. Save the result to the `$newAppliance` variable.

2. Run the [`Get-VBRCloudProvider`](get-vbrcloudprovider.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$CloudProvider` variable.
3. Run the `Set-VBRCloudProvider` cmdlet. Set the `$CloudProvider` variable as the `CloudProvider` parameter value. Set the `$newAppliance` variable as the `Appliance` parameter value.

:::

## Related Commands

- [`Set-VBRCloudProviderNetworkAppliance`](set-vbrcloudprovidernetworkappliance.md)
- [`Get-VBRCloudProvider`](get-vbrcloudprovider.md)