---
title: "Set-VBORbacRole"
description: "This cmdlet modifies settings of the specified restore operator role. To modify settings, you need to enter the necessary parameters with new values. The parameters that you omit will remain unchanged."
canonical: "https://helpcenter.veeam.com/docs/vbo365/powershell/set-vborbacrole.html"
breadcrumb: "PowerShell Reference > Veeam Backup for Microsoft 365 PowerShell Reference > Restore Portal > Set-VBORbacRole"
dateModified: "2026-08-21"
---

# Set-VBORbacRole

## Short Description
Modifies settings of restore operator roles that are added to Veeam Backup for Microsoft 365.

## Syntax

This cmdlet provides the following parameter sets:

<ul class="syntax-sets">
  <li>
    <p><code>SelectedBackupItemsParameterSet (Default)</code></p>

```
Set-VBORbacRole -Role <VBOOperatorRole> [-Name <String>] [-Description <String>]
 [-Operators <VBORbacOperator[]>] [-SelectedItems <VBORbacRoleItem[]>] [-ExcludedItems <VBORbacRoleItem[]>] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>EntireOrganizationParameterSet</code></p>

```
Set-VBORbacRole -Role <VBOOperatorRole> [-Name <String>] [-Description <String>]
 [-Operators <VBORbacOperator[]>] [-EntireOrganization] [-ExcludedItems <VBORbacRoleItem[]>] [<CommonParameters>]
```
  </li>
</ul>

## Detailed Description
This cmdlet modifies settings of the specified restore operator role. To modify settings, you need to enter the necessary parameters with new values. The parameters that you omit will remain unchanged.

## 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">Description</span></p>
        </td>
        <td>
          <p>Specifies a description of the restore operator role. The cmdlet will replace the current description with the specified description.</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">EntireOrganization</span></p>
        </td>
        <td>
          <p>Defines that the specified restore operators will be able to explore and restore all objects within the specified Microsoft 365 organization.</p><p>Default: <em>False</em></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">ExcludedItems</span></p>
        </td>
        <td>
          <p>Specifies an array of objects to exclude. The cmdlet will replace the current objects to exclude with the specified ones.</p><p><strong>Note</strong>: You cannot exclude objects that have been specified for the <code>SelectedItems</code> parameter.</p><p>Accepts the <a href="vborbacroleitem.md"><code>VBORbacRoleItem</code></a><code>[]</code> object.</p><p>To create this object, run the <a href="new-vborbacroleitem.md"><code>New-VBORbacRoleItem</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vborbacroleitem.md"><code>VBORbacRoleItem[]</code></a></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">Name</span></p>
        </td>
        <td>
          <p>Specifies a restore operator role name. The cmdlet will replace the current name with the specified name.</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">Operators</span></p>
        </td>
        <td>
          <p>Specifies an array of restore operators. The cmdlet will replace the current restore operators with the specified restore operators.</p><p>Accepts the <a href="vborbacoperator.md"><code>VBORbacOperator</code></a><code>[]</code> object.</p><p>To create this object, run the <a href="new-vborbacoperator.md"><code>New-VBORbacOperator</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vborbacoperator.md"><code>VBORbacOperator[]</code></a></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">Role</span></p>
        </td>
        <td>
          <p>Specifies a restore operator role.</p><p>The cmdlet will modify settings of this restore operator role.</p><p>Accepts the <a href="vbooperatorrole.md"><code>VBOOperatorRole</code></a> object.</p><p>To get this object, run the <a href="get-vborbacrole.md"><code>Get-VBORbacRole</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbooperatorrole.md"><code>VBOOperatorRole</code></a></p>
        </td>
        <td style="width:10%;">
          <p>True</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>True (ByValue)</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">SelectedItems</span></p>
        </td>
        <td>
          <p>Specifies an array of objects to manage. The cmdlet will replace the current objects to manage with the specified ones.</p><p>Accepts the <a href="vborbacroleitem.md"><code>VBORbacRoleItem</code></a><code>[]</code> object.</p><p>To create this object, run the <a href="new-vborbacroleitem.md"><code>New-VBORbacRoleItem</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vborbacroleitem.md"><code>VBORbacRoleItem[]</code></a></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 the [About Common Parameters](http://go.microsoft.com/fwlink/p/?LinkID=113216) section of Microsoft Learn.

## Output Object
The cmdlet returns the [`VBOOperatorRole`](vbooperatorrole.md) object that contains the restore operator role settings.

## Examples

::: example
### Modifying Restore Operators List

This example shows how to change a list of restore operators added to the specified restore operator role.

```
$org = Get-VBOOrganization -Name "ABC"
$role = Get-VBORbacRole -Name "ABC Restore Operators"
$User = Get-VBOOrganizationUser -Organization $org -UserName "userAlpha@tech.onmicrosoft.com"
$newrestoreoperator = New-VBORbacOperator -User $User
Set-VBORbacRole -Role $role -Operators $newrestoreoperator
```

Perform the following steps:

1. Run the [`Get-VBOOrganization`](get-vboorganization.md) cmdlet with the `Name` parameter to get the organization with the name *ABC*. Save the result to the `$org` variable.
2. Run the [`Get-VBORbacRole`](get-vborbacrole.md) cmdlet with the `Name` parameter to get the restore operator role whose settings you want to modify. Save the result to the `$role` variable.
3. Run the [`Get-VBOOrganizationUser`](get-vboorganizationuser.md) cmdlet with the `$org` variable and the `userAlpha@tech.onmicrosoft.com` value for the `UserName` parameter to get an organization user with the name *userAlpha*. Save the result to the `$User` variable.
4. Run the [`New-VBORbacOperator`](new-vborbacoperator.md) cmdlet. Set the `$User` variable as the `User` parameter value. Save the result to the `$newrestoreoperator` variable.
5. Run the `Set-VBORbacRole` cmdlet. Set the `$role` variable as the `Role` parameter value and the `$newrestoreoperator` variable as the `Operators` parameter value.

:::

## Related Commands

- [`Get-VBOOrganization`](get-vboorganization.md)
- [`Get-VBORbacRole`](get-vborbacrole.md)
- [`Get-VBOOrganizationUser`](get-vboorganizationuser.md)
- [`New-VBORbacOperator`](new-vborbacoperator.md)
- [`New-VBORbacRoleItem`](new-vborbacroleitem.md)