community.network.icx_user модуль – Управление учетными записями пользователей на коммутаторах Ruckus ICX 7000 серии.

Примечание

Этот модуль входит в коллекцию community.network (версия 5.0.3).

У вас, возможно, уже установлена эта коллекция, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить установку, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install community.network.

Чтобы использовать её в книге задач, укажите: community.network.icx_user.

Обзор
Параметры
Примечания
Примеры
Возвращаемые значения

Обзор

Этот модуль создаёт или обновляет учетные записи пользователей на сетевых устройствах. Он позволяет книгам задач управлять либо отдельными именами пользователей, либо совокупностью имён пользователей в текущей конфигурации. Он также поддерживает удаление имён пользователей из конфигурации, которые не определены явно.

Псевдонимы: network.icx.icx_user

Параметры

Параметр	Комментарии
access_time строка	Этот параметр указывает время, к которому должно быть установлено время доступа к файлу. Должен сохраняться при отсутствии необходимости изменения, YYYYMMDDHHMM.SS при использовании формата времени по умолчанию или now. Значение по умолчанию — None, означающее, что preserve — значение по умолчанию для state=[file,directory,link,hard], а now — значение по умолчанию для state=touch
aggregate псевдонимы: users, collection список / элементы=словарь	Набор объектов имен пользователей, которые должны быть настроены на удаленном устройстве ICX. Элементы списка могут представлять собой имя пользователя или хэш из имени пользователя и свойств. Этот аргумент взаимоисключающий с аргументом `name`.
access_time строка	Этот параметр указывает время, к которому должно быть установлено время доступа к файлу. Должен сохраняться при отсутствии необходимости изменения, YYYYMMDDHHMM.SS при использовании формата времени по умолчанию или now. Значение по умолчанию — None, означающее, что preserve — значение по умолчанию для state=[file,directory,link,hard], а now — значение по умолчанию для state=touch
check_running_config логическое значение	Проверка текущей конфигурации. Это можно установить в качестве переменной среды. Модуль будет использовать значение переменной среды (по умолчанию: True), если оно не переопределено путем указания его в качестве параметра модуля. Варианты: `false` `true`
configured_password строка	Пароль, который должен быть настроен на устройстве ICX.
name строка / обязательный	Имя пользователя, которое должно быть настроено на устройстве ICX.
nopassword логическое значение	Определяет имя пользователя без присвоения пароля. Это позволит пользователю войти в систему без проверки по паролю. Варианты: `false` `true`
privilege строка	Уровень привилегий, который должен быть предоставлен пользователю Варианты: `"0"` `"4"` `"5"`
state строка	Настраивает состояние определения имени пользователя, относящееся к рабочей конфигурации устройства. При установке в значение present имя пользователя(и) должно быть настроено в активной конфигурации устройства, а при установке в значение absent имя пользователя(и) не должно находиться в активной конфигурации устройства Варианты: `"present"` `"absent"`
update_password строка	Этот аргумент укажет модулю, когда необходимо изменить пароль. При установке в значение `always`, пароль всегда будет обновляться на устройстве, а при установке в значение `on_create` пароль будет обновлен только в случае создания имени пользователя. Варианты: `"on_create"` `"always"`
check_running_config логическое значение	Проверка текущей конфигурации. Это можно установить в качестве переменной среды. Модуль будет использовать значение переменной среды (по умолчанию: True), если оно не переопределено путем указания его в качестве параметра модуля. Варианты: `false` `true` ← (по умолчанию)
configured_password строка	Пароль, который должен быть настроен на устройстве ICX.
name строка / обязательный	Имя пользователя, которое должно быть настроено на устройстве ICX.
nopassword логическое значение	Определяет имя пользователя без присвоения пароля. Это позволит пользователю войти в систему без проверки по паролю. Варианты: `false` ← (по умолчанию) `true`
privilege строка	Уровень привилегий, который должен быть предоставлен пользователю Варианты: `"0"` `"4"` `"5"`
purge логическое значение	Если установлено в значение true, модуль удалит любые ранее настроенные имена пользователей на устройстве, кроме текущего набора определенных пользователей. Варианты: `false` ← (по умолчанию) `true`

END_OF_DOCUMENT_MARKER

состояние

строка

Настраивает состояние определения имени пользователя, как оно относится к рабочей конфигурации устройства. При установке в present имена пользователей должны быть настроены в активной конфигурации устройства, а при установке в absent — имена пользователей не должны быть в активной конфигурации устройства

Варианты:

"present" ← (по умолчанию)
"absent"

update_password

строка

Этот аргумент укажет модулю, когда нужно изменить пароль. При установке в always, пароль всегда будет обновлен на устройстве, а при установке в on_create пароль будет обновлен только в том случае, если пользователь создан.

Варианты:

"on_create"
"always" ← (по умолчанию)

Примечания

Примечание

Проверено на ICX 10.1.
Дополнительную информацию об использовании платформы ICX см. в руководстве по параметрам платформы ICX OS.

Примеры

- name: Create a new user without password
  community.network.icx_user:
    name: user1
    nopassword: true

- name: Create a new user with password
  community.network.icx_user:
    name: user1
    configured_password: 'newpassword'

- name: Remove users
  community.network.icx_user:
    name: user1
    state: absent

- name: Set user privilege level to 5
  community.network.icx_user:
    name: user1
    privilege: 5

Значения возврата

Общие значения возврата описаны здесь, а следующие поля уникальны для данного модуля:

Ключ	Описание
команды список / элементы=строка	Список команд режима конфигурации для отправки на устройство Возвращается: всегда Пример: `["username ansible nopassword", "username ansible password-string alethea123", "no username ansible", "username ansible privilege 5", "username ansible enable"]`

Авторы

Ruckus Wireless (@Commscope)

Ссылки на сборку

© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/community/network/icx_user_module.html