group – Добавление или удаление групп
Описание
- Управление наличием групп на хосте.
- Для целевых систем Windows используйте модуль win_group.
Требования
Ниже перечислены требования, которые должны быть выполнены на хосте, на котором выполняется этот модуль.
- groupadd
- groupdel
- groupmod
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| gid целое число | Необязательный GID для задания группе. | |
| local логическое добавлено в 2.6 |
| Принудительно использует альтернативные команды "локальные" на платформах, которые их реализуют. Это полезно в средах с централизованной аутентификацией, когда требуется управление локальными группами. (например, использует lgroupadd вместо groupadd).Это требует, чтобы эти команды существовали на целевом хосте, в противном случае произойдет ошибка. |
| name строка / обязательно | Имя группы для управления. | |
| non_unique логическое добавлено в 2.8 |
| Этот параметр позволяет изменить идентификатор группы на не уникальное значение. Требуется gid. Не поддерживается в macOS или дистрибутивах BusyBox. |
| state строка |
| Указывает, должно ли группа существовать на удаленном хосте. |
| system логическое |
| Если да, указывает, что созданная группа является системной группой. |
См. также
См. также
- user – Управление учетными записями пользователей
- Официальная документация модуля user.
- win_group – Добавление и удаление локальных групп
- Официальная документация модуля win_group.
Примеры
- name: Ensure group "somegroup" exists
group:
name: somegroup
state: present
Статус
- Гарантируется отсутствие изменений интерфейса, несовместимых со старыми версиями. [stableinterface]
- Этот модуль поддерживается командой Ansible Core. [core]
Поддержка Red Hat
Дополнительную информацию о поддержке этого модуля Red Hat можно найти в этой статье базы знаний Red Hat.
Авторы
- Stephen Fromm (@sfromm)
Подсказка
Если вы обнаружите какие-либо проблемы в этой документации, вы можете изменить этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.8/modules/group_module.html
