dellemc.openmanage.ome_user – Создание, изменение или удаление пользователя в OpenManage Enterprise
Примечание
Этот плагин является частью коллекции dellemc.openmanage (версия 3.0.0).
Для его установки используйте: ansible-galaxy collection install dellemc.openmanage.
Для использования в playbook, укажите: dellemc.openmanage.ome_user.
Новое в версии 2.0.0: dellemc.openmanage
Краткое описание
- Этот модуль создает, изменяет или удаляет пользователя в OpenManage Enterprise.
Требования
Ниже указаны требования, необходимые на хосте, который выполняет этот модуль.
- python >= 2.7.5
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| attributes словарь | Значение по умолчанию: {} | Данные полезной нагрузки для операций с пользователем. Он может принимать следующие атрибуты для present.UserTypeId, DirectoryServiceId, Description, Name, Password, UserName, RoleId, Locked, Enabled. OME выдаст ошибку, если для операции не будет предоставлен необходимый параметр. Дополнительные сведения см. в справочном руководстве по API OpenManage Enterprise. |
| hostname строка / обязательно | Целевой IP-адрес или имя хоста. | |
| name строка | Уникальное имя пользователя, который необходимо удалить. Либо user_id, либо name является обязательным для операции absent. | |
| password строка / обязательно | Пароль целевого пользователя. | |
| port целое число | Значение по умолчанию: 443 | Целевой порт HTTPS. |
| state строка |
| present создает пользователя, если предоставленное в attributes имя пользователя UserName не существует.present изменяет пользователя, если предоставленное в attributes имя пользователя UserName существует.absent удаляет существующего пользователя. |
| user_id целое число | Уникальный ID пользователя, который необходимо удалить. Либо user_id, либо name является обязательным для операции absent. | |
| username строка / обязательно | Имя пользователя. |
Примечания
Примечание
- Запустите этот модуль с системы, имеющей прямой доступ к DellEMC OpenManage Enterprise.
- Этот модуль не поддерживает
check_mode.
Примеры
---
- name: Create user with required parameters
dellemc.openmanage.ome_user:
hostname: "192.168.0.1"
username: "username"
password: "password"
attributes:
UserName: "user1"
Password: "UserPassword"
RoleId: "10"
Enabled: True
- name: Create user with all parameters
dellemc.openmanage.ome_user:
hostname: "192.168.0.1"
username: "username"
password: "password"
attributes:
UserName: "user2"
Description: "user2 description"
Password: "UserPassword"
RoleId: "10"
Enabled: True
DirectoryServiceId: 0
UserTypeId: 1
Locked: False
Name: "user2"
- name: Modify existing user
dellemc.openmanage.ome_user:
hostname: "192.168.0.1"
username: "username"
password: "password"
state: "present"
attributes:
UserName: "user3"
RoleId: "10"
Enabled: True
Description: "Modify user Description"
- name: Delete existing user using id
dellemc.openmanage.ome_user:
hostname: "192.168.0.1"
username: "username"
password: "password"
state: "absent"
user_id: 1234
- name: Delete existing user using name
dellemc.openmanage.ome_user:
hostname: "192.168.0.1"
username: "username"
password: "password"
state: "absent"
name: "name"
Возвращаемые значения
Общие возвращаемые значения описаны здесь, следующие поля являются уникальными для этого модуля:
| Ключ | Возвращается | Описание |
|---|---|---|
| msg строка | всегда | Общее состояние операции с пользователем. Пример: Пользователь успешно создан |
| user_status словарь | Когда state равно present. | Подробности операции с пользователем, когда state равно present.Пример: {'Description': 'Test user creation', 'DirectoryServiceId': 0, 'Enabled': True, 'Id': '61546', 'IsBuiltin': False, 'Locked': False, 'Name': 'test', 'Password': None, 'PlainTextPassword': None, 'RoleId': '10', 'UserName': 'test', 'UserTypeId': 1} |
Авторы
- Sajna Shetty(@Sajna-Shetty)
© 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/dellemc/openmanage/ome_user_module.html
