---
title: "Get-VBRUserRoleAssignment"
description: "Returns a role that is assigned to a user or a user group. Product Edition: Standard, Enterprise, Enterprise Plus, Veeam Universal License This cmdlet provides the following parameter sets: This cmdlet returns a role that is assigned to a user or a u"
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/get-vbruserroleassignment.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Backup Infrastructure > Roles and Users > Get-VBRUserRoleAssignment"
dateModified: "2026-08-19"
---

# Get-VBRUserRoleAssignment

## Short Description
Returns a role that is assigned to a user or a user group.

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

## Syntax

This cmdlet provides the following parameter sets:

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

```
Get-VBRUserRoleAssignment [-Name <String[]>] [-RoleEntity <VBRRoleEntity[]>] [-Type <VBRRoleType[]>] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>Role</code></p>

```
Get-VBRUserRoleAssignment [-Name <String[]>] [-Role <VBRRole[]>] [-Type <VBRRoleType[]>] [<CommonParameters>]
```
  </li>
</ul>

## Detailed Description
This cmdlet returns a role that is assigned to a user or a user group.

## 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">Name</span></p>
        </td>
        <td>
          <p>Specifies an array of names of users or user groups. The cmdlet will get roles that are assigned to these users or user groups.</p><p><strong>Note</strong>: You must specify the name of a user or a user group in the <em>DOMAIN\Username</em> format.</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>True (ByPropertyName, ByValue)</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 role that you want to get. You can get one of the following roles:</p><ul><li><code>BackupOperator</code></li><li><code>RestoreOperator</code></li><li><code>BackupAdmin</code></li><li><code>TapeOperator</code></li><li><code>BackupViewer</code></li><li><code>IncidentApiOperator</code></li><li><code>SecurityAdministrator</code></li><li><code>Custom</code></li></ul>
        </td>
        <td style="width:10%;">
          <p><code>VBRRole[]</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">RoleEntity</span></p>
        </td>
        <td>
          <p>Specifies a role that you want to get. The cmdlet will return the roles assigned to the user or a user group..</p><p>Accepts the <a href="vbrroleentity.md"><code>VBRRoleEntity</code></a> object. To get this object, run the <a href="get-vbrroleentity.md"><code>Get-VBRRoleEntity</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbrroleentity.md"><code>VBRRoleEntity[]</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">Type</span></p>
        </td>
        <td>
          <p>Specifies a type of the user which role you want to get. You can specify one of the following type of a user:</p><ul><li><code>User</code></li><li><code>Group</code></li></ul>
        </td>
        <td style="width:10%;">
          <p><code>VBRRoleType[]</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>
    </table>

`<CommonParameters>`

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see [ Microsoft Docs](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_commonparameters?view=powershell-7).

## Output Object
The cmdlet returns the `VBRUserRoleAssignment` object that defines a role for a user or a user group

## Examples

::: example
### Example 1. Getting Role of Specific User

This command returns a role that is assigned to the `Tech\BackupAdmin` user. The cmdlet output will contain the following details `RoleEntity`, `Role`, `Type`, `Name` and `Id`.

```
Get-VBRUserRoleAssignment -Name Tech\BackupAdmin
RoleEntity : Backup Administrator
Role       : BackupAdmin
Type       : Group
Name       : Administrators
Id         : c5d266c7-8e2b-43f9-92c6-fffc4297074d
```

:::

::: example
### Example 2. Getting All Users and User Groups with Specific Role

This command returns all users and user groups that have the Backup Operator role. The cmdlet output will contain the following details `RoleEntity`, `Role`, `Type`, `Name` and `Id`.

```
Get-VBRUserRoleAssignment -Role BackupOperator
RoleEntity : Backup Operator
Role       : BackupOperator
```

:::

::: example
### Example 3. Getting Role Assigned Through a Custom Role Entity

This command returns the role that is assigned through the `Role_01X` custom role entity. The cmdlet output will contain the following details `RoleEntity`, `Role`, `Type`, `Name` and `Id`.

```
Get-VBRUserRoleAssignment -RoleEntity (Get-VBRRoleEntity -Name "Role_01X")
RoleEntity : Role_01X
Role       : Custom
Type       : User
Name       : Tech\jsmith
Id         : 3fa85f64-5717-4562-b3fc-2c963f66afa6
```

:::

## Related Commands

[`Get-VBRRoleEntity`](get-vbrroleentity.md)