salt.modules.win_groupadd

Manage groups on Windows

salt.modules.win_groupadd.add(name, **kwargs)

Add the specified group

Parameters:	name (str) -- The name of the group to add
Returns:	True if successful, otherwise False
Return type:	bool

CLI Example:

salt '*' group.add foo

salt.modules.win_groupadd.adduser(name, username, **kwargs)

Add a user to a group

Parameters:	name (str) -- The name of the group to modify username (str) -- The name of the user to add to the group
Returns:	True if successful, otherwise False
Return type:	bool

CLI Example:

salt '*' group.adduser foo username

salt.modules.win_groupadd.delete(name, **kwargs)

Remove the named group

Parameters:	name (str) -- The name of the group to remove
Returns:	True if successful, otherwise False
Return type:	bool

CLI Example:

salt '*' group.delete foo

salt.modules.win_groupadd.deluser(name, username, **kwargs)

Remove a user from a group

Parameters:	name (str) -- The name of the group to modify username (str) -- The name of the user to remove from the group
Returns:	True if successful, otherwise False
Return type:	bool

CLI Example:

salt '*' group.deluser foo username

salt.modules.win_groupadd.getent(refresh=False)

Return info on all groups

Parameters:	refresh (bool) -- Refresh the info for all groups in __context__. If False only the groups in __context__ will be returned. If True the __context__ will be refreshed with current data and returned. Default is False
Returns:	A list of groups and their information

CLI Example:

salt '*' group.getent

salt.modules.win_groupadd.info(name)

Return information about a group

Parameters:	name (str) -- The name of the group for which to get information
Returns:	A dictionary of information about the group
Return type:	dict

CLI Example:

salt '*' group.info foo

salt.modules.win_groupadd.list_groups(refresh=False)

Return a list of groups

Parameters:	refresh (bool) -- Refresh the info for all groups in __context__. If False only the groups in __context__ will be returned. If True, the __context__ will be refreshed with current data and returned. Default is False
Returns:	A list of groups on the machine
Return type:	list

CLI Example:

salt '*' group.list_groups

salt.modules.win_groupadd.members(name, members_list, **kwargs)

Ensure a group contains only the members in the list

Parameters:	name (str) -- The name of the group to modify members_list (str) -- A single user or a comma separated list of users. The group will contain only the users specified in this list.
Returns:	True if successful, otherwise False
Return type:	bool

CLI Example:

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