dellemc.openmanage.ome_user_info – Retrieves details of all accounts or a specific account on OpenManage Enterprise
Note
This plugin is part of the dellemc.openmanage collection (version 3.0.0).
To install it use: ansible-galaxy collection install dellemc.openmanage.
To use it in a playbook, specify: dellemc.openmanage.ome_user_info.
New in version 2.0.0: of dellemc.openmanage
Synopsis
- This module retrieves the list and basic details of all accounts or details of a specific account on OpenManage Enterprise.
Requirements
The below requirements are needed on the host that executes this module.
- python >= 2.7.5
Parameters
| Parameter | Choices/Defaults | Comments | |
|---|---|---|---|
| account_id integer | Unique Id of the account. | ||
| hostname string / required | Target IP address or hostname. | ||
| password string / required | Target user password. | ||
| port integer | Default: 443 | Target HTTPS port. | |
| system_query_options dictionary | Options for filtering the output. | ||
| filter string | Filter records for the supported values. | ||
| username string / required | Target username. | ||
Notes
Note
- Run this module from a system that has direct access to DellEMC OpenManage Enterprise.
- This module supports
check_mode.
Examples
---
- name: Retrieve basic details of all accounts
dellemc.openmanage.ome_user_info:
hostname: "192.168.0.1"
username: "username"
password: "password"
- name: Retrieve details of a specific account identified by its account ID
dellemc.openmanage.ome_user_info:
hostname: "192.168.0.1"
username: "username"
password: "password"
account_id: 1
- name: Get filtered user info based on user name
dellemc.openmanage.ome_user_info:
hostname: "192.168.0.1"
username: "username"
password: "password"
system_query_options:
filter: "UserName eq 'test'"
Return Values
Common return values are documented here, the following are the fields unique to this module:
| Key | Returned | Description |
|---|---|---|
| msg string | on error | Over all status of fetching user facts. Sample: Unable to retrieve the account details. |
| user_info dictionary | success | Details of the user. Sample: {'192.168.0.1': {'Description': 'user name description', 'DirectoryServiceId': 0, 'Enabled': True, 'Id': '1814', 'IsBuiltin': True, 'Locked': False, 'Name': 'user_name', 'Password': None, 'RoleId': '10', 'UserName': 'user_name', 'UserTypeId': 1}} |
Authors
- Jagadeesh N V(@jagadeeshnv)
© 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_info_module.html