NAME
Get-DcsRole
SYNOPSIS
Returns user role data.
SYNTAX
Get-DcsRole [ -Role <Object> ] [ -Connection <String> ] [ -PipelineVariable <String> ]
DESCRIPTION
Returns user role data. Data can be returned for all roles or a specified role.
PARAMETERS
- -Role<Object>
- RoleData object, ID, or alias that identifies a specific role.
-
- Required: false
- Position: 1
- Default value:
- Accept pipeline input: false
- 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
-
INPUTS
RoleData : Object that identifies and describes the user role.
OUTPUTS
RoleData : Object that identifies and describes the user role.
NOTES
Also see Add-DcRole, Remove-DcsRole.
EXAMPLES
-------------- Example 1 Returns data for a specified role. --------------
Get-DcsRole -Role "Networking"
The cmdlet is invoked to return data for the ole named "Networking". The RoleData object is returned.
| Alias | : | Networking |
| Description | : | Role for Network Administrators |
| Privileges | : | General privileges: All |
| Port privileges | : | All |
| Host privileges | : | All |
| Host group privileges | : | All |
| DataCore Server privileges | : | All |
| DataCore Server group privileges | : | All |
| Virtual disk privileges | : | All |
| Snapshot privileges | : | All |
| Rollback privileges | : | All |
| Replication privileges | : | All |
| Physical disk privileges | : | All |
| Disk pool privileges | : | All |
| Service level privileges | : | All |
| Replication partner privileges | : | All |
| Task privileges | : | All |
| System health monitor privileges | : | All |
| Log privileges | : | All |
| Virtual disk group privileges | : | All |
| Performance recording privileges | : | All |
| IsPredefined | : | False |
| Sequencenumber | : | 3146 |
| Id | : | 5a418634-6ca6-410b-a25e-2ab33bb7b417 |
| Caption | : | Networking |
| ExtendedCaption | : | Networking |
| Internal | : | False |
-------------- Example 2 Returns data for all roles --------------
Get-DcsRole
The cmdlet is invoked without specifying a specific role which returns all roles in the server group.
| Alias | : | Full Privileges |
| Description | : | Role with full privileges |
| Privileges | : | All |
| IsPredefined | : | True |
| Sequencenumber | : | 37 |
| 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 | : | 38 |
| 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 | : | 39 |
| Id | : | {E1077253-9FD3-4460-A39A-7A13AF1E885E} |
| Caption | : | VVol Managers |
| ExtendedCaption | : | VVol Managers |
| Internal | : | False |
| Alias | : | Networking |
| Description | : | Role for Network Administrators |
| Privileges | : | General privileges: All |
| Port privileges | : | All |
| Host privileges | : | All |
| Host group privileges | : | All |
| DataCore Server privileges | : | All |
| DataCore Server group privileges | : | All |
| Virtual disk privileges | : | All |
| Snapshot privileges | : | All |
| Rollback privileges | : | All |
| Replication privileges | : | All |
| Physical disk privileges | : | All |
| Disk pool privileges | : | All |
| Service level privileges | : | All |
| Replication partner privileges | : | All |
| Task privileges | : | All |
| System health monitor privileges | : | All |
| Log privileges | : | All |
| Virtual disk group privileges | : | All |
| Performance recording privileges | : | All |
| IsPredefined | : | False |
| Sequencenumber | : | 3146 |
| Id | : | 5a418634-6ca6-410b-a25e-2ab33bb7b417 |
| Caption | : | Networking |
| ExtendedCaption | : | Networking |
| Internal | : | False |