Removes users or groups from a local group.
Remove-GroupMember [-Name] <String> [-Member] <String[]> [-WhatIf] [-Confirm] [<CommonParameters>]You would think it's pretty easy and straight-forward to remove users/groups from a local group, but you would be wrong. The quick solution is to use net localgroup, but that won't accept user/group names longer than 24 characters. This means you have to use the .NET Directory Services APIs. How do you reliably remove both users and groups? What if those users are in a domain? What if they're in another domain? What about built-in users? Fortunately, your brain hasn't exploded.
So, this function removes users or groups from a local group.
If the user or group is not a member, nothing happens.
Remove-GroupMember is new in Carbon 2.0.
| Name | Type | Description | Required? | Pipeline Input | Default Value |
|---|---|---|---|---|---|
| Name | String | The group name. |
true | false | |
| Member | String[] | The users/groups to remove from a group. |
true | false | |
| WhatIf | SwitchParameter | false | false | ||
| Confirm | SwitchParameter | false | false | ||
| CommonParameters | This cmdlet supports common parameters. For more information type Get-Help about_CommonParameters. |
Remove-GroupMember -Name Administrators -Member EMPIRE\DarthVader,EMPIRE\EmperorPalpatine,REBELS\LSkywalkerRemoves Darth Vader, Emperor Palpatine and Luke Skywalker from the local administrators group.
Remove-GroupMember -Name TieFighters -Member NetworkServiceRemoves the local NetworkService account from the local TieFighters group.