icx_user – Управление учетными записями пользователей на коммутаторах Ruckus ICX 7000 серии
Новая версия 2.9.
Обзор
- Этот модуль создаёт или обновляет учётные записи пользователей на сетевых устройствах. Он позволяет плейбукам управлять либо отдельными именами пользователей, либо совокупностью имён пользователей в текущей конфигурации. Он также поддерживает удаление имён пользователей из конфигурации, которые не определены явно.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| access_time строка | Этот параметр указывает время, к которому должно быть установлено время доступа к файлу. Должен сохраняться при отсутствии необходимости в модификации, YYYYMMDDHHMM.SS при использовании формата времени по умолчанию или now. Значение по умолчанию — None, что означает, что preserve является значением по умолчанию для state=[file,directory,link,hard], а now — для state=touch | ||
| aggregate список | Набор объектов имен пользователей, которые должны быть настроены на удалённом устройстве ICX. Элементы списка могут быть либо именем пользователя, либо хешем имени пользователя и свойств. Этот аргумент несовместим с аргументом name. алиасы: users, collection | ||
| access_time строка | Этот параметр указывает время, к которому должно быть установлено время доступа к файлу. Должен сохраняться при отсутствии необходимости в модификации, YYYYMMDDHHMM.SS при использовании формата времени по умолчанию или now. Значение по умолчанию — None, что означает, что preserve является значением по умолчанию для state=[file,directory,link,hard], а now — для state=touch | ||
| check_running_config логическое |
| Проверка текущей конфигурации. Это можно задать как переменную окружения. Модуль будет использовать значение переменной окружения (значение по умолчанию:True), если оно не переопределено, задав его в качестве параметра модуля. | |
| configured_password строка | Пароль, который должен быть настроен на устройстве ICX. | ||
| name строка / обязательно | Имя пользователя, которое должно быть настроено на устройстве ICX. | ||
| nopassword логическое |
| Определяет имя пользователя без присвоения пароля. Это позволит пользователю войти в систему без проверки по паролю. | |
| privilege строка |
| Уровень привилегий, предоставляемых пользователю | |
| state строка |
| Настраивает состояние определения имени пользователя по отношению к рабочей конфигурации устройства. При значении present имя пользователя(ов) должно быть настроено в активной конфигурации устройства, а при значении absent — нет. | |
| update_password строка |
| Этот аргумент указывает, когда необходимо изменить пароль. При значении always, пароль всегда обновляется на устройстве, а при значении on_create пароль обновляется только при создании имени пользователя. | |
| check_running_config логическое |
| Проверка текущей конфигурации. Это можно задать как переменную окружения. Модуль будет использовать значение переменной окружения (значение по умолчанию:True), если оно не переопределено, задав его в качестве параметра модуля. | |
| configured_password строка | Пароль, который должен быть настроен на устройстве ICX. | ||
| name строка / обязательно | Имя пользователя, которое должно быть настроено на устройстве ICX. | ||
| nopassword логическое |
| Определяет имя пользователя без присвоения пароля. Это позволит пользователю войти в систему без проверки по паролю. | |
| privilege строка |
0 | Уровень привилегий, предоставляемых пользователю | |
| purge логическое |
| Если установлено в значение true, модуль удалит все ранее настроенные имена пользователей на устройстве, кроме текущего набора определённых пользователей. | |
| state строка |
| Настраивает состояние определения имени пользователя по отношению к рабочей конфигурации устройства. При значении present имя пользователя(ов) должно быть настроено в активной конфигурации устройства, а при значении absent — нет. | |
| update_password строка |
| Этот аргумент указывает, когда необходимо изменить пароль. При значении always, пароль всегда обновляется на устройстве, а при значении on_create пароль обновляется только при создании имени пользователя. | |
Примечания
Примечание
- Проверено на ICX 10.1.
- Дополнительная информация об использовании платформы ICX доступна в руководстве Options платформы ICX OS.
Примеры
- name: create a new user without password
icx_user:
name: user1
nopassword: true
- name: create a new user with password
icx_user:
name: user1
configured_password: 'newpassword'
- name: remove users
icx_user:
name: user1
state: absent
- name: set user privilege level to 5
icx_user:
name: user1
privilege: 5
Возвращаемые значения
Общие значения возврата описаны здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| commands список | всегда | Список команд режима конфигурации для отправки на устройство Пример: ['username ansible nopassword', 'username ansible password-string alethea123', 'no username ansible', 'username ansible privilege 5', 'username ansible enable'] |
Статус
- Этот модуль не гарантирует обратной совместимости интерфейса. [превью]
- Этот модуль поддерживается сообществом Ansible. [community]
Авторы
- Ruckus Wireless (@Commscope)
Подсказка
Если вы обнаружите какие-либо проблемы в этом документе, вы можете отредактировать этот документ, чтобы улучшить его.
© 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/icx_user_module.html
