---
title: "Add-VBRCloudProvider"
description: "This cmdlet adds a new service provider to Veeam Backup & Replication. You can add several providers using one cloud gateway to your Veeam backup console. The provider credentials must have different user names."
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/add-vbrcloudprovider.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Veeam Cloud Connect > Veeam Cloud Connect Service Provider > Add-VBRCloudProvider"
dateModified: "2026-08-19"
---

# Add-VBRCloudProvider

## Short Description
Adds cloud service providers.

**Platform**: VMware, Hyper-V

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

## Syntax
```
Add-VBRCloudProvider -Address <String> [-Description <String>] [-Port <Int32>]
 -Credentials <VBRCloudProviderCredentials> [-Appliance <VBRCloudProviderNetworkAppliance[]>]
 [-VerifyCertificate] [-CertificateThumbprint <String>] [-InstallManagementAgent] [-Force]
 [-RestoreAccessLevel <VBRVccRestoreAccessLevel>] [<CommonParameters>]
```

## Detailed Description
This cmdlet adds a new service provider to Veeam Backup & Replication.

You can add several providers using one cloud gateway to your Veeam backup console. The provider credentials must have different user names.

You must set a network extension appliance if you plan to replicate your VMs to the cloud. Pre-configure the network extension appliance in advance. For details, see [Network Appliance](user_network_appliance.md).

::: important

The `CCredentials` type 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.

:::

## 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 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>True</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 network extension appliance on the user side.</p><p>You must configure a network extension appliance if you want to replicate to the cloud.</p><p>Accepts the <a href="vbrhvcloudprovidernetworkappliance.md"><code>VBRHvCloudProviderNetworkAppliance[]</code></a> object. To get this object, run the <a href="new-vbrcloudprovidernetworkappliance.md"><code>New-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">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>True</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 cmdlet 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">Port</span></p>
        </td>
        <td>
          <p>Specifies the port over which user's Veeam backup server 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>: 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. Adding Cloud Service Provider with Default Settings

This example shows how to add a cloud service provider to Veeam Backup & Replication using default settings. The service provider IP address is `198.51.100.11`.

```
$credentials = Get-VBRCloudProviderCredentials -Name "Tenant1"
Add-VBRCloudProvider -Address "198.51.100.11" -Credentials $credentials
```

Perform the following steps:

1. Run the [`Get-VBRCloudProviderCredentials`](get-vbrcloudprovidercredentials.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$credentials` variable.
2. Run the `Add-VBRCloudProvider` cmdlet. Specify the `Address` parameter value. Set the `$credentials` variable as the `Credentials` parameter value.

:::

::: example
### Example 2. Adding Cloud Service Provider with Specific Settings

This example shows how to add a cloud service provider with the following settings:

- The service provider IP address is `198.51.100.11`.
- The service provider uses port `6252` for connection.
- The TLS certificate thumbprint verification is enabled. The thumbprint is `‎e6 c0 e5 1a db 73 0c 13 b3 c3 74 d4 ee 93 ab d0 08 3f 7a a8`.
- The service provider can restore unencrypted backups.

```
$credentials = Get-VBRCloudProviderCredentials -Name "Tenant1"
Add-VBRCloudProvider -Address "198.51.100.11" -Description "Cloud gateway for SP" -Port 6252 -Credentials $credentials -VerifyCertificate -CertificateThumbprint "‎e6 c0 e5 1a db 73 0c 13 b3 c3 74 d4 ee 93 ab d0 08 3f 7a a8" -RestoreAccessLevel UnencryptedBackups
```

Perform the following steps:

1. Run the [`Get-VBRCloudProviderCredentials`](get-vbrcloudprovidercredentials.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$credentials` variable.
2. Run the `Add-VBRCloudProvider` cmdlet. Specify the following settings:

   - Specify the `Address` and the `Description` parameter values.
   - Specify the `Port` parameter value.
   - Set the `$credentials` variable as the `Credentials` parameter value.
   - Provide the `VerifyCertificate` parameter.
   - Specify the `CertificateThumbprint` parameter value.
   - Specify the `RestoreAccessLevel` parameter value.

:::

::: example
### Example 3. Adding Cloud Service Provider and Configuring Network Extension Appliance

This example shows how to add a service provider and configure a network extension appliance. The service provider IP address is `198.51.100.11`.

```
$server = Get-VBRServer -Type HvServer -Name "srv02.tech.local"
$folder = "C:\Datastore"
$network = Get-VBRHvServerNetworkInfo -Server $server  | Where { $_.NetworkName -eq "VM Network" }
$viAppl = New-VBRCloudProviderNetworkAppliance -Server $server -Network $network -Folder $folder
$credentials = Get-VBRCloudProviderCredentials -Name "Tenant1"
Add-VBRCloudProvider -Address "198.51.100.11" -Credentials $credentials -Appliance $viAppl
```

Perform the following steps:

1. Create a network extension appliance: 

   - Run the [`Get-VBRServer`](get-vbrserver.md) cmdlet. Set the `HvServer` option for the `Type` parameter. Specify the `Name` parameter value. Save the server to the `$server` variable.
   - Assign the `C:\Datastore` value to the `$folder` variable.
   - Run the [`Get-VBRHvServerNetworkInfo`](get-vbrhvservernetworkinfo.md) cmdlet. Set the `$server` variable as the `Server` parameter value and use the `Where-Object` statement to filter the networks by the .`NetworkName` property. Save the network to the `$network` variable.
   - Run the [`New-VBRCloudProviderNetworkAppliance`](new-vbrcloudprovidernetworkappliance.md) cmdlet. Specify the `Server`, `Network` and `Folder` parameter values. Save the result to the `$viAppl` variable.

2. Run the [`Get-VBRCloudProviderCredentials`](get-vbrcloudprovidercredentials.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$credentials` variable.
3. Run the `Add-VBRCloudProvider` cmdlet. Specify the `Address` parameter value. Set the `$credentials` variable as the `Credentials` parameter value. Set the `$viAppl` variable as the `Appliance` parameter value.

:::

## Related Commands

- [`Get-VBRCloudProviderCredentials`](get-vbrcloudprovidercredentials.md)
- [`Get-VBRCloudProviderNetworkAppliance`](get-vbrcloudprovidernetworkappliance.md)