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 list | всегда | Список команд конфигурации режима для отправки на устройство Пример: ['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. [community]
Авторы
- 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.9/modules/cnos_user_module.html
