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
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 |
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 |