group – Добавление или удаление групп
Описание
- Управление наличием групп на хосте.
- Для целей Windows используйте модуль win_group вместо этого.
Требования
Ниже перечислены требования к хосту, на котором выполняется этот модуль.
- groupadd
- groupdel
- groupmod
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| gid целое число | Необязательный GID для установки группы. | |
| local логическое значение добавлено в 2.6 |
| Принудительно использует альтернативные команды "local" на платформах, которые их поддерживают. Это полезно в средах с централизованной аутентификацией, когда вы хотите управлять локальными группами. (например, он использует 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.9/modules/group_module.html
