salt.modules.pw_group¶

Manage groups on FreeBSD

Important

If you feel that Salt should be using this module to manage groups on a minion, and it is using a different module (or gives an error similar to 'group.info' is not available), see here.

salt.modules.pw_group.add(name, gid=None, **kwargs)¶

Add the specified group

CLI Example:

salt '*' group.add foo 3456

salt.modules.pw_group.chgid(name, gid)¶

Change the gid for a named group

CLI Example:

salt '*' group.chgid foo 4376

salt.modules.pw_group.delete(name)¶

Remove the named group

CLI Example:

salt '*' group.delete foo

salt.modules.pw_group.getent(refresh=False)¶

Return info on all groups

CLI Example:

salt '*' group.getent

salt.modules.pw_group.info(name)¶

Return information about a group

CLI Example:

salt '*' group.info foo

salt.modules.pw_group.members(name, members_list)¶

Replaces members of the group with a provided list.

New in version 2015.5.4.

CLI Example:

salt '*' group.members foo 'user1,user2,user3,...'

Replaces a membership list for a local group 'foo'.: foo:x:1234:user1,user2,user3,...