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