# $cs.UsrMgr_EnumMembersOfLocalGroup

> Returns the members of a local group. The group parameter accepts either a group name or a SID (a SID is resolved to a name internally before enumeration).

Source: https://docs.capaone.com/capainstaller/powerpacks/cs-usrmgr-enummembersoflocalgroup/  
Product: CapaInstaller — a separate CapaSystems product; do not apply this page to any other.

### Description

Returns the members of a local group. The `group` parameter accepts either a group name or a SID (a SID is resolved to a name internally before enumeration). Each returned object exposes the member's identity as a caption/name string.

### Syntax

$cs.UsrMgr_EnumMembersOfLocalGroup(string group)

### Parameters

#### group (String)

Name or SID of the local group to enumerate.

### Return value

A `Collection<PSObject>` listing the members of the group.

### Example

**PowerShell**

Audit and log the current members of `Administrators` before making any changes, so the pre-install state is captured for troubleshooting:

```powershell
$groupMembers = $cs.UsrMgr_EnumMembersOfLocalGroup('Administrators')
foreach ($item in $groupMembers) {
  $cs.Job_WriteLog("Member found: $($item)")
}
```

Check whether a specific user is already a member of a group before adding them, to avoid redundant calls:

```powershell
$members = $cs.UsrMgr_EnumMembersOfLocalGroup('S-1-5-32-544')
$alreadyMember = $members | Where-Object { $_.ToString() -like '*capaadmin*' }

if (-not $alreadyMember) {
  $cs.Job_WriteLog("capaadmin is not yet a member of Administrators, adding it")
  $cs.UsrMgr_AddUserToLocalGroup('capaadmin', 'S-1-5-32-544')
} else {
  $cs.Job_WriteLog("capaadmin is already a member of Administrators, skipping")
}
```

### Related functions

[$cs.UsrMgr_AddUserToLocalGroup](/capainstaller/powerpacks/cs-usrmgr-addusertolocalgroup/) [$cs.UsrMgr_RemoveUserFromLocalGroup](/capainstaller/powerpacks/cs-usrmgr-removeuserfromlocalgroup/) [$cs.UsrMgr_GetNameBySid](/capainstaller/powerpacks/cs-usrmgr-getnamebysid/)