community.network.cnos_user – Управление набором локальных пользователей на устройствах Lenovo CNOS
Примечание
Этот плагин входит в коллекцию community.network (версия 2.0.1).
Для его установки используйте: ansible-galaxy collection install community.network.
Для использования в книге задач укажите: community.network.cnos_user.
Обзор
- Этот модуль предоставляет декларативное управление локальными именами пользователей, настроенными на устройствах Lenovo CNOS. Он позволяет книгам задач управлять либо отдельными именами пользователей, либо набором имён пользователей в текущей конфигурации. Он также поддерживает удаление имён пользователей из конфигурации, которые не определены явно.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| aggregate строка | Набор объектов имен пользователей, которые будут настроены на удалённом устройстве Lenovo CNOS. Элементы списка могут быть либо именем пользователя, либо словарем с именем пользователя и свойствами. Этот аргумент несовместим с аргументом name.Псевдонимы: users, collection | |
| configured_password строка | Пароль, который будет настроен на сетевом устройстве. Пароль должен быть предоставлен в открытом виде, и он будет зашифрован на устройстве. Обратите внимание, что этот параметр отличается от provider password. | |
| name строка | Имя пользователя, которое будет настроено на удалённом устройстве Lenovo CNOS. Этот аргумент принимает строковое значение и несовместим с аргументом aggregate. | |
| purge логическое значение |
| Аргумент purge указывает модулю рассматривать определение ресурса как абсолютное. Он удалит все ранее настроенные имена пользователей на устройстве, за исключением пользователя `admin`, который не может быть удалён в соответствии с ограничениями cnos. |
| role строка | Аргумент role настраивает роль для имени пользователя в рабочей конфигурации устройства. Аргумент принимает строковое значение, определяющее имя роли. Этот аргумент не проверяет, была ли на устройстве настроена роль.Псевдонимы: roles | |
| sshkey строка | Аргумент sshkey определяет открытый ключ SSH для настройки для имени пользователя. Этот аргумент принимает допустимое значение ключа SSH. | |
| state строка |
| Аргумент state настраивает состояние определения имени пользователя по отношению к рабочей конфигурации устройства. При установке в present имя(на) пользователя(ей) должно быть настроено в активной конфигурации устройства, а при установке в absent имя(на) пользователя(ей) не должно быть в активной конфигурации устройства. |
| update_password строка |
| Поскольку пароли зашифрованы в рабочей конфигурации устройства, этот аргумент укажет модулю, когда нужно изменить пароль. При установке в always, пароль всегда будет обновлён на устройстве, а при установке в on_create, пароль будет обновлён только в случае создания имени пользователя. |
Примеры
- name: Create a new user
community.network.cnos_user:
name: ansible
sshkey: "{{ lookup('file', '~/.ssh/id_rsa.pub') }}"
state: present
- name: Remove all users except admin
community.network.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 |
Авторы
- Anil Kumar Muraleedharan (@amuraleedhar)
© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/community/network/cnos_user_module.html
