Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
Removes a member from a user role.
Parameter Set: Default
Remove-SCACUserRoleMember [-UserRole] <ACUserRole> [-Member] <String> [ <CommonParameters>]
The Remove-SCACUserRoleMember function removes the specified member from a user role.
Specifies the name of the member to remove from a user role.
Aliases |
none |
Required? |
true |
Position? |
2 |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
Specifies a user role object. To retrieve a user role object, use the Get-SCUserRole cmdlet.
Aliases |
none |
Required? |
true |
Position? |
1 |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).
The input type is the type of the objects that you can pipe to the cmdlet.
The output type is the type of the objects that the cmdlet emits.
Description
-----------
The first command gets the user role object named UserRole01 and stores the object in the $UserRole variable.
The second command removes the member named Contoso\ReneeLo from the user role stored in $UserRole.
PS C:\> $UserRole = Get-SCACUserRole –Managed | where { $_.Name –eq "UserRole01" }
PS C:\> Remove-SCACUserRoleMember –UserRole $UserRole –Member "Contoso\ReneeLo"