Remove-SCACUserRoleMember
Remove-SCACUserRoleMember
Removes a member from a user role.
Syntax
Parameter Set: Default
Remove-SCACUserRoleMember [-UserRole] <ACUserRole> [-Member] <String> [ <CommonParameters>]
Detailed Description
The Remove-SCACUserRoleMember function removes the specified member from a user role.
Parameters
-Member<String>
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 |
-UserRole<ACUserRole>
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 |
<CommonParameters>
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).
Inputs
The input type is the type of the objects that you can pipe to the cmdlet.
Outputs
The output type is the type of the objects that the cmdlet emits.
Examples
-------------------------- EXAMPLE 1 --------------------------
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"