cnos_user – Управление локальными пользователями на устройствах Lenovo CNOS
Новое в версии 2.8.
Описание
- Этот модуль предоставляет декларативное управление локальными именами пользователей, настроенными на устройствах Lenovo CNOS. Он позволяет плейбукам управлять либо отдельными именами пользователей, либо коллекцией имен пользователей в текущей рабочей конфигурации. Он также поддерживает очистку имен пользователей из конфигурации, которые не определены явно.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| aggregate - | Набор объектов имен пользователей, которые должны быть настроены на удалённом устройстве Lenovo CNOS. Элементы списка могут быть либо именем пользователя, либо хешем имени пользователя и свойств. Этот аргумент взаимоисключает аргумент name. Псевдонимы: users, collection | |
| configured_password - | Пароль, который должен быть настроен на сетевом устройстве. Пароль необходимо указать в открытом виде, и он будет зашифрован на устройстве. Обратите внимание, что этот параметр не эквивалентен параметру provider password. | |
| name - | Имя пользователя, которое должно быть настроено на удалённом устройстве Lenovo CNOS. Этот аргумент принимает строковое значение и взаимоисключает аргумент aggregate. | |
| purge boolean |
| Аргумент purge указывает модулю рассматривать определение ресурса как абсолютное. Он удалит всех ранее настроенных пользователей на устройстве, за исключением пользователя `admin`, который не может быть удалён по ограничениям CNOS. |
| role - | Аргумент role настраивает роль для имени пользователя в рабочей конфигурации устройства. Аргумент принимает строковое значение, определяющее имя роли. Этот аргумент не проверяет, была ли роль настроена на устройстве.Псевдонимы: roles | |
| sshkey - | Аргумент sshkey определяет открытый ключ SSH для настройки для имени пользователя. Этот аргумент принимает допустимое значение ключа SSH. | |
| state - |
| Аргумент state настраивает состояние определения имени пользователя, которое относится к рабочей конфигурации устройства. При установке в present имя пользователя(ей) должно быть настроено в активной конфигурации устройства, а при установке в absent имя пользователя(ей) не должно быть в активной конфигурации устройства. |
| update_password - |
| Поскольку пароли зашифрованы в рабочей конфигурации устройства, этот аргумент укажет, когда изменить пароль. При установке в always, пароль всегда будет обновлён на устройстве, а при установке в on_create пароль будет обновлён только при создании имени пользователя. |
Примеры
- name: create a new user
cnos_user:
name: ansible
sshkey: "{{ lookup('file', '~/.ssh/id_rsa.pub') }}"
state: present
- name: remove all users except admin
cnos_user:
purge: yes
- name: set multiple users role
aggregate:
- name: netop
- name: netend
role: network-operator
state: present
Возвращаемые значения
Общие возвращаемые значения документированы здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| commands список | всегда | Список команд конфигурации режима, которые нужно отправить на устройство Пример: ['name ansible', 'name ansible password password'] |
| delta строка | всегда | Время, затраченное на выполнение всех операций Пример: 0:00:10.469466 |
| end строка | всегда | Время завершения задачи Пример: 2016-11-16 10:38:25.595612 |
| start строка | всегда | Время начала задачи Пример: 2016-11-16 10:38:15.126146 |
Статус
- Этот модуль не гарантирует обратной совместимости. [предварительная версия]
- Этот модуль поддерживается сообществом Ansible. [сообщество]
Авторы
- Anil Kumar Muraleedharan (@amuraleedhar)
Подсказка
Если вы заметите какие-либо проблемы в этом документе, вы можете отредактировать этот документ, чтобы улучшить его.
© 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/cnos_user_module.html
