Home NT Commands
NT Syntax

IFMEMBER (Resource Kit)

Count the NT Workgroups that the current user is in.

syntax
      IFMEMBER [options] WorkGroup [ WorkGroup2 WorkGroup3...]

options:
        /verbose or /v   : print all matches.
        /list    or /l   : print all groups user is a member of

The %ERRORLEVEL% return code shows how many of the listed workgroups the currently logged-in user is a member of.

Examples

IFMEMBER /v /l "MyDomain\Administrators"
IF ERRORLEVEL 1 echo This user is an Administrator

Notice that the syntax here is the opposite to normal in that
%ERRORLEVEL% = 1 = Success
with most other NT commands %ERRORLEVEL% = 1 = Fail/Error

The best way to utilise IFMEMBER is through conditional execution...

IFMEMBER Administrators || ECHO Error is 1 so [%Username%] is in Admin_WG

IFMEMBER Administrators && ECHO Error is 0 so [%Username%] is NOT in Admin_WG

Related Commands:
NET GROUP - add or remove a user from a workgroup
SHOWMBRS - List the members of an NT Workgroup
SHOWACCS - Show access profile (Windows 2000)
GRPTEST - SMS support tools - enumerate group membership for a user account.
Cusrmgr - Console User Manager. (Win 2K ResKit)
Joeware.net - MemberOf.exe - Like IFMEMBER but able to handle nested AD groups.

Equivalent Linux BASH commands:



Simon Sheppard
SS64.com