This is an archive version of the document. To get the most up-to-date information, see the current version.

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

Get-VBRUserRoleAssignment [-Name <string[]>] [-Role {BackupOperator | RestoreOperator | BackupAdmin | TapeOperator | BackupViewer}] [-Type {User | Group}]  [<CommonParameters>]

Detailed Description

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

Parameters

Parameter

Description

Type

Required

Position

Accept Pipeline Input

Name

Specifies an array of names of users or user groups. The cmdlet will get roles that are assigned to these users or user groups.

Note: You must specify the name of a user or a user group in the DOMAIN\Username format.

String[]

False

Named

True (ByValue,
ByProperty
Name)

Role

Specifies a role that you want to get. You can assign one of the following roles:

  • BackupOperator
  • RestoreOperator
  • BackupAdmin
  • TapeOperator
  • BackupViewer

 

False

Named

False

Type

Specifies a type of the user which role you want to get. You can specify one of the following type of a user:

  • User
  • Group

 

False

Named

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

The cmdlet returns the VBRUserRoleAssignment object that defines a role for a user or a user group

Examples

Get-VBRUserRoleAssignmentExample 1. Getting Role of Specific User

Get-VBRUserRoleAssignmentExample 2. Getting All Users and User Groups with Specific Role