NAME

Get-DcsUserRole

SYNOPSIS

Returns role data.

SYNTAX

Get-DcsUserRole   [ -Role <Object> ]   [ -Connection <String> ]   [ -PipelineVariable <String> ]

Get-DcsUserRole   [ -User <Object> ]   [ -Connection <String> ]   [ -PipelineVariable <String> ]

DESCRIPTION

Returns role data. All possible roles, a specific role, or all roles for a specific user can be returned. Roles are used to grant user privileges.

PARAMETERS

-Role<Object>
RoleData object, Alias, or ID that identifies a role. If specified, only data for that role will be returned.

Required: false
Position: 1
Default value:
Accept pipeline input: true (ByValue)
Accept wildcard characters: false

-Connection<String>
Alias of the connection to the server group. If not specified, the default connection is used.

Required: false
Position: named
Default value:
Accept pipeline input: false
Accept wildcard characters: false

-PipelineVariable<String>

Required: false
Position: named
Default value:
Accept pipeline input: false
Accept wildcard characters: false

-User<Object>
UserData object, name, or ID that identifies a user. If specified, only data for that user will be returned.

Required: false
Position: 2
Default value:
Accept pipeline input: false
Accept wildcard characters: false

INPUTS

RoleData : Object that identifies the role.

OUTPUTS

RoleData : Object that identifies and describes the user role.

NOTES

Also see Add-DcsUserRole, Remove-DcsUserRole.

EXAMPLES


-------------- Example 1 Returns data for all user roles --------------
Get-DcsUserRole
		

Returns data for all possible user roles.

Alias:Full Privileges
Description:Role with full privileges
Privileges:All
IsPredefined:True
Sequencenumber:10317
Id:{DAD4B92D-BFC8-4628-A313-51D8B2F57083}
Caption:Full Privileges
ExtendedCaption:Full Privileges
Internal:False
   
Alias:View
Description:Role with view-only privileges
Privileges:General privileges: ViewInformation
   
IsPredefined:True
Sequencenumber:10318
Id:{B1210FAD-5DAC-4a7b-B3D6-EEB8DFFE1F7A}
Caption:View
ExtendedCaption:View
Internal:False
   
Alias:VVol Managers
Description:Role with privileges on VVol related operations
Privileges:General privileges: ViewInformation
Port privileges:All
Host privileges:All
DataCore Server privileges:RescanDisks
Virtual disk privileges:All
Snapshot privileges:All
Physical disk privileges:All
User account privileges:AssignIdentifiable
Virtual disk group privileges:All
Virtual disk template privileges:All
   
IsPredefined:True
Sequencenumber:10319
Id:{E1077253-9FD3-4460-A39A-7A13AF1E885E}
Caption:VVol Managers
ExtendedCaption:VVol Managers
Internal:False
   
Alias:Networking
Description:
Privileges:General privileges: All
Port privileges:All
Host privileges:All
Host group privileges:All
DataCore Server privileges:All
DataCore Server group privileges:All
Service level privileges:All
Task privileges:All
   
IsPredefined:False
Sequencenumber:10972
Id:68b11804-1575-4ab1-8945-95b0ff37a526
Caption:Networking
ExtendedCaption:Networking
Internal:False
   

-------------- Example 2 Returns roles for a specific user. --------------
Get-DcsUserRole -User "Larry C. Moe"
		

The cmdlet is invoked with the user specified by name. All roles for the specified user are returned. In this case, there is one role.

Alias:View
Description:Role with view-only privileges
Privileges:General privileges: ViewInformation
   
IsPredefined:True
Sequencenumber:10318
Id:{B1210FAD-5DAC-4a7b-B3D6-EEB8DFFE1F7A}
Caption:View
ExtendedCaption:View
Internal:False