Disable-VBRHvProxy

Short Description

Disables the Hyper-V backup proxy.

Platform: Hyper-V

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

Syntax

Disable-VBRHvProxy -Proxy <CHvProxy[]> [<CommonParameters>]

Detailed Description

This cmdlet allows you to disable the Hyper-V backup proxy. The disabled proxy is not used by any job.

Run the Enable-VBRHvProxyEnables the disabled Hyper-V backup proxy. cmdlet to enable the Hyper-V backup proxy.

Parameters

Parameters

Parameter

Description

Type

Required

Position

Accept Pipeline Input

Proxy

Specifies an array of the Hyper-V proxies you want to disable.

Accepts the CHvProxy[] object. To get this object, run the Get-VBRHvProxyReturns a list of the Hyper-V backup proxies. cmdlet.

CHvProxy[]

True

Named

True (ByPropertyName, ByValue)

<CommonParameters>

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

Output Object

The cmdlet returns the CHvProxy[] that contains an array of Hyper-V backup proxy servers added to the backup infrastructure.

Examples

Disable-VBRHvProxyExample 1. Disabling Hyper-V Backup Proxy [Using Variable]

This example shows how to disable the Hyper-V backup proxy named Local Backup Proxy.

$proxy = Get-VBRHvProxy -Name "Local Backup Proxy"

Disable-VBRHvProxy -Proxy $proxy

Perform the following steps:

  1. Run the Get-VBRHvProxyReturns a list of the Hyper-V backup proxies. cmdlet. Specify the Name parameter value. Save the result to the $proxy variable.
  2. Run the Disable-VBRHvProxy cmdlet. Set the $proxy variable as the Proxy parameter value.

Disable-VBRHvProxyExample 2. Disabling Hyper-V Backup Proxy [Using Pipeline]

This example shows how to disable the Hyper-V backup proxy named Hyper-V Backup Proxy 01.

Get-VBRHvProxy -Name "Hyper-V Backup Proxy 01" | Disable-VBRHvProxy

Perform the following steps:

  1. Run the Get-VBRHvProxyReturns a list of the Hyper-V backup proxies. cmdlet. Specify the Name parameter value.
  2. Pipe the cmdlet output to the Disable-VBRHvProxy cmdlet.

Get-VBRHvProxyReturns a list of the Hyper-V backup proxies.

Page updated 2026-08-19

Page content applies to build 13.1.1.18