member -- manipulate Windows NT/2000/XP/2003/Vista group membership

SYNOPSIS

member -u user [-e] [-S hostname | -D domain-name] (-a|-d) [-G|-L] group

member -g group [-e] [-S hostname | -D domain-name] (-a|-d) [-G|-L] user

DESCRIPTION

member changes the membership list for a user or group.

When the -u user option is specified, user is added or deleted from a list of groups. When the -g group option is specified, the list of users is added or deleted from the specified group.

Options

-a

adds each specified user or group that is not part of the -u user or -g group options.

-d

deletes each specified user or group that is not part of the -u user or -g group options.

-Ddomain-name

locates the primary domain controller of domain-name, and requests that machine to perform the actions on behalf of the member command. member normally performs actions on the local system.

The -D and -S options are mutually exclusive.

-e

displays the error number contained in the errno variable for any system error that occurs and exits. You can use the strerror utility to display the system error message corresponding to this error number.

-g group

selects a group. The list of specified users are added or deleted from this group's user list.

-G

treats all group names given as global groups. This is the default.

-L

treats all group names given as local groups.

-S hostname

specifies the host machine that the member command requests to perform actions on its behalf. member normally performs actions on the local system. Optionally, hostname may be preceded by \\ or //.

The -D and -S options are mutually exclusive.

-u user

selects a user. The list of specified groups are added or deleted from this user's group membership.

For a more complete description of group membership, and an explanation of local groups versus global groups, see your Windows NT/2000/XP/2003/Vista administrative documentation.

EXAMPLES

For an example of member usage, see the userinfo reference page.

The following code might be used to remove user Sandy from the Accounting and Development groups:

member -S '\\MyServer' -G -u Sandy -d Accounting Development

DIAGNOSTICS

Possible exit status values are:

0: Successful completion.
1: A system error occurred.
2: A usage error occurred.

PORTABILITY

Windows NT 4.0. Windows 2000. Windows XP. Windows Server 2003.

AVAILABILITY

MKS Toolkit for System Administrators
MKS Toolkit for Developers
MKS Toolkit for Interoperability
MKS Toolkit for Professional Developers
MKS Toolkit for Enterprise Developers
MKS Toolkit for Enterprise Developers 64-Bit Edition

member
manipulate Windows NT/2000/XP/2003/Vista group membership

Command