NAME
Remove-DcsUserRole
SYNOPSIS
Removes a role from an existing user.
SYNTAX
Remove-DcsUserRole -User <Object> -Role <String> [ -Connection <String> ] [ -PipelineVariable <String> ]
DESCRIPTION
Removes a role from an existing user. The role assigns the privilege level, so if removed the user will no longer have the associated privileges.
PARAMETERS
- -User<Object>
- UserData object, user name, or ID that identifies the user.
-
- Required: true
- Position: 1
- Default value:
- Accept pipeline input: true (ByValue)
- Accept wildcard characters: false
-
- -Role<String>
- Name or ID of the role to remove from the user. User roles can be attained with the Get-DcsUserRole cmdlet.
-
- Required: true
- Position: 2
- 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 will be 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
UserData : Object that identifies and describes the user.
OUTPUTS
UserData : Object that identifies and describes the user.
NOTES
Also see Get-DcsUserRole, Add-DcsUserRole, Remove-DcsUser.
EXAMPLES
-------------- Example 1 Removes a role from a user specified by name --------------
Remove-DcsUserRole -User "Larry Howard" -Role "Full Privileges"
Removes the "Full Privileges" role from the user named "Larry Howard".
Name | : | Larry Howard |
Description | : | |
EmailAddress | : | |
BlendedPrivileges | : | ViewInformation |
IsAdministrator | : | False |
RoleIds | : | {{B1210FAD-5DAC-4a7b-B3D6-EEB8DFFE1F7A}} |
Id | : | 5b2cf3ad-04f3-447f-960e-2c70e8484773 |
Caption | : | Larry Howard |
ExtendedCaption | : | Larry Howard |
Internal | : | False |