dellemc.openmanage.idrac_user_info 模块 – 获取iDRAC上所有用户或特定用户的详细信息。

注意

此模块是 dellemc.openmanage 集合 (版本 9.9.0) 的一部分。

如果您使用的是 ansible 软件包，则可能已安装此集合。它不包含在 ansible-core 中。要检查是否已安装它，请运行 ansible-galaxy collection list。

要安装它，请使用： ansible-galaxy collection install dellemc.openmanage。您需要其他要求才能使用此模块，有关详细信息，请参见要求。

要在playbook中使用它，请指定： dellemc.openmanage.idrac_user_info。

dellemc.openmanage 7.0.0 中的新增功能

概要 

此模块检索iDRAC上所有用户的列表和基本信息，或特定用户的详细信息

要求 

执行此模块的主机需要以下要求。

python >= 3.9.6

参数 

参数	注释
ca_path 路径在 dellemc.openmanage 5.0.0 中添加	包含用于验证的CA证书的隐私增强邮件 (PEM) 文件。
idrac_ip 字符串 / 必需	iDRAC IP地址。
idrac_password 别名：idrac_pwd 字符串	iDRAC 用户密码。如果未提供密码，则使用环境变量 `IDRAC_PASSWORD`。示例：export IDRAC_PASSWORD=password
idrac_port 整数	iDRAC端口。默认值： `443`
idrac_user 字符串	iDRAC用户名。如果未提供用户名，则使用环境变量 `IDRAC_USERNAME`。示例：export IDRAC_USERNAME=username
timeout 整数在 dellemc.openmanage 5.0.0 中添加	以秒为单位的套接字级别超时。默认值： `30`
user_id 整数	支持从1到16的顺序用户ID号。 user_id 与 username 互斥
username 字符串	在iDRAC本地用户中创建的帐户的用户名。 username 与 user_id 互斥
validate_certs 布尔值在 dellemc.openmanage 5.0.0 中添加	如果为 `false`，则不会验证SSL证书。仅在使用自签名证书的个人控制站点上配置 `false`。在集合版本 `5.0.0` 之前，validate_certs 默认值为 `false`。选项 `false` `true` ← (默认)
x_auth_token 字符串在 dellemc.openmanage 9.3.0 中添加	身份验证令牌。如果未提供x_auth_token，则使用环境变量 `IDRAC_X_AUTH_TOKEN`。示例：export IDRAC_X_AUTH_TOKEN=x_auth_token

注释 

注意

在可以直接访问Dell iDRAC的系统上运行此模块。
此模块支持 check_mode。

示例 

---
- name: Retrieve basic details of all user accounts.
  dellemc.openmanage.idrac_user_info:
    idrac_ip: 198.162.0.1
    idrac_user: idrac_user
    idrac_password: idrac_password
    ca_path: "/path/to/ca_cert.pem"

- name: Retrieve user details using user_id
  dellemc.openmanage.idrac_user_info:
    idrac_ip: 198.162.0.1
    idrac_user: idrac_user
    idrac_password: idrac_password
    ca_path: "/path/to/ca_cert.pem"
    user_id: 1

- name: Retrieve user details using username
  dellemc.openmanage.idrac_user_info:
    idrac_ip: 198.162.0.1
    idrac_user: idrac_user
    idrac_password: idrac_password
    ca_path: "/path/to/ca_cert.pem"
    username: user_name

返回值 

公共返回值已在此处记录，以下是此模块特有的字段

键	描述
error_info 字典	HTTP错误的详细信息。返回： HTTP错误时示例： `{"error": {"@Message.ExtendedInfo": [{"Message": "Unable to process the request because an error occurred.", "MessageArgs": [], "MessageId": "GEN1234", "RelatedProperties": [], "Resolution": "Retry the operation. If the issue persists, contact your system administrator.", "Severity": "Critical"}], "code": "Base.1.0.GeneralError", "message": "A general error has occurred. See ExtendedInfo for more information."}}`
msg 字符串	用户信息检索的状态。返回：始终示例： `"Successfully retrieved the user information."`
user_info 列表 / 元素=字符串	关于用户的信息。返回：成功示例： `[{"Description": "用户帐户", "Enabled": false, "Id": "1", "Locked": false, "Name": "用户帐户", "Password": null, "RoleId": "None", "UserName": ""}]`

作者

Husniya Hameed(@husniya_hameed)