Set-VBRCDPProxy

Short Description

Modifies settings of VMware CDP proxies added to the backup infrastructure.

Applies to

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

Syntax

Set-VBRCDPProxy -Proxy <VBRCDPProxy> [-Description <string>] [-CacheSize <uint32>] [-CachePath <string>] [-SourceProxyTrafficPort <int>] [-TargetProxyTrafficPort <int>] [-Force]  [<CommonParameters>]

Detailed Description

This cmdlet modifies settings of VMware CDP proxies added to the backup infrastructure. To modify settings, you need to specify new values for the necessary parameters. The parameters that you omit will remain unchanged.

Parameters

Parameter

Description

Type

Required

Position

Accept Pipeline Input

Proxy

Specifies a VMware CDP proxy. The cmdlet will modify the settings of this proxy.

Accepts the VBRCDPProxy object. To create this object, run the Get-VBRCDPProxy cmdlet.

True

Named

True (ByValue, ByPropertyName)

Description

Specifies a description for a VMware CDP proxy.

String

False

Named

False

CacheSize

Specifies a size of a cache for a VMware CDP proxy.
Note: When you specify the cache size, keep in mind the following recommendations:

  • You need to allocate 1 GB for each protected VM.
  • You need to leave 10 percent of the proxy storage free.

Default: GB.

Uint32

False

Named

False

CachePath

Specifies a path to the folder where you want to keep a global cache.

Default: C:\VeeamCDP

String

False

Named

False

SourceProxyTrafficPort

Specifies the port number of the source proxy.

Int

False

Named

False

TargetProxyTrafficPort

Specifies the port number of the target proxy.

Int

False

Named

False

Force

Defines that the cmdlet will modify a VMware CDP proxy without showing warnings in the PowerShell console.

SwichParameter

False

Named

False

<CommonParameters>

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see the About CommonParameters section of Microsoft Docs.

Output Object

The cmdlet returns the VBRCDPProxy object that contains VMware CDP proxies to the backup infrastructure settings.

Examples

Set-VBRCDPProxyExample 1. Modifying VMware CDP Proxy Cache Size

This example shows how to modify a size of the cache that is used by the Proxy05 VMware CDP proxy.

$proxy = Get-VBRCDPProxy -Name "Proxy05"

Set-VBRCDPProxy -Proxy $proxy -CacheSize "25"

Perform the following steps:

  1. Run the Get-VBRCDPProxy cmdlet. Save the result to the $proxy variable.
  2. Run the Set-VBRCDPProxy cmdlet. Set the $proxy variable as the Proxy parameter value. Specify the CacheSize parameter value.

Set-VBRCDPProxyExample 2. Modifying VMware CDP Proxy Cache Location

This example shows how to modify a path to the folder where the Proxy05 VMware CDP proxy keeps the cache.

$proxy = Get-VBRCDPProxy

Set-VBRCDPProxy -Proxy $proxy -CachePath "C:\CacheFolder"

Perform the following steps:

  1. Run the Get-VBRCDPProxy cmdlet. Save the result to the $proxy variable.
  2. Run the Set-VBRCDPProxy cmdlet. Set the $proxy variable as the Proxy parameter value. Specify the CachePath parameter value.

Related Commands

Get-VBRCDPProxy