Remove-VBOProxy

Short Description

Removes backup proxies.

Syntax

Remove-VBOProxy -Proxy <VBOProxy> [-Force] [-Credential <PSCredential>] [-WhatIf] [-Confirm]  [<CommonParameters>]

Detailed Description

This cmdlet allows you to remove a specified backup proxy from the Veeam Backup for Microsoft 365 infrastructure.

Parameters

Parameter

Description

Type

Required

Position

Accept Pipeline Input

Accept Wildcard Characters

Proxy

Specifies a backup proxy. The cmdlet will remove this backup proxy from the Veeam Backup for Microsoft 365 infrastructure.

Accepts the VBOProxy object.

To get this object, run the Get-VBOProxy cmdlet.

True

Named

True (ByValue)

False

Force

Defines that the cmdlet will remove a backup proxy server without showing warnings in the PowerShell console.

If you do not provide the parameter, the cmdlet will prompt you to confirm the operation.

SwitchParameter

False

Named

False

False

Credential

Specifies Windows credentials. The cmdlet will use these credentials to connect to the backup proxy server.

If you omit this parameter, to connect to the backup proxy server, the cmdlet will use the Windows credentials under which you are currently logged in.

PSCredential

False

Named

False

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

False

Confirm

Defines that the cmdlet will display a prompt that asks if the user is sure that he wants to continue.

Default: True

SwitchParameter

False

Named

False

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

None.

Examples

Remove-VBOProxyExample 1. Removing Backup Proxy from Veeam Backup for Microsoft 365 Infrastructure

This example shows how to remove the tech.support.local backup proxy from the Veeam Backup for Microsoft 365 infrastructure.

$proxy = Get-VBOProxy -Hostname "tech.support.local"

Remove-VBOProxy -Proxy $proxy

Perform the following steps:

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

Related Commands

Get-VBOProxy