Remove-VBORbacRole

Short Description

Removes restore operator roles from Veeam Backup for Microsoft 365.

Syntax

Remove-VBORbacRole -Role <VBOOperatorRole> [-WhatIf] [-Confirm] [<CommonParameters>]

Detailed Description

This cmdlet removes the specified restore operator role from Veeam Backup for Microsoft 365.

Parameters

Parameter	Description	Type	Required	Position	Accept Pipeline Input	Accept Wildcard Characters
Role	Specifies a restore operator role that you want to remove.	Accepts the VBOOperatorRole object. To get this object, run the Get-VBORbacRole cmdlet.	True	Named	True (ByValue)	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

Parameter

Description

Type

Required

Position

Accept Pipeline Input

Accept Wildcard Characters

Role

Specifies a restore operator role that you want to remove.

Accepts the VBOOperatorRole object.

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

True

Named

True (ByValue)

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

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

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-VBORbacRole Example 1. Removing Restore Operator Role

This example shows how to remove the f3f29c99-20b4-4eaa-9615-3b4c9d913a69 restore operator role.

$role = Get-VBORbacRole -Id f3f29c99-20b4-4eaa-9615-3b4c9d913a69

Remove-VBORbacRole -Role $role -Confirm

Perform the following steps:

Run the Get-VBORbacRole cmdlet. Specify the Id parameter value. Save the result to the $role variable.
Run the Remove-VBORbacRole cmdlet. Specify the following settings:

Set the $role variable as the Role parameter value.
Provide the Confirm parameter.

Related Commands

Get-VBORbacRole