community.general.hpilo_info 模块 – 通过 HP iLO 接口收集信息

注意

此模块是 community.general 集合（版本 10.1.0）的一部分。

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

要安装它，请使用：ansible-galaxy collection install community.general。您需要进一步的要求才能使用此模块，请参阅要求以了解详细信息。

要在 playbook 中使用它，请指定：community.general.hpilo_info。

概要 

此模块使用其 HP iLO 接口收集有关特定系统的信息。这些信息包括硬件和网络相关信息，对配置很有用（例如 mac 地址，uuid）。
此模块需要 hpilo python 模块。

要求 

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

hpilo

参数 

参数	说明
host 字符串 / 必需	链接到物理系统的 HP iLO 主机名/地址。
login 字符串	用于向 HP iLO 接口进行身份验证的登录名。默认值： `"Administrator"`
password 字符串	用于向 HP iLO 接口进行身份验证的密码。默认值： `"admin"`
ssl_version 字符串	更改使用的 ssl_version。选项 `"SSLv3"` `"SSLv23"` `"TLSv1"` ←（默认） `"TLSv1_1"` `"TLSv1_2"`

属性 

属性	支持	描述
check_mode	支持：完全此操作不会修改状态。	可以在 `check_mode` 中运行并返回已更改的状态预测，而无需修改目标。
diff_mode	支持：不适用此操作不会修改状态。	当处于 diff 模式时，将返回已更改（或可能需要在 `check_mode` 中更改）的详细信息。

备注 

注意

此模块应该从可以直接访问 HP iLO 接口的系统运行，可以使用 local_action 或使用 delegate_to。

示例 

- name: Gather facts from a HP iLO interface only if the system is an HP server
  community.general.hpilo_info:
    host: YOUR_ILO_ADDRESS
    login: YOUR_ILO_LOGIN
    password: YOUR_ILO_PASSWORD
  when: cmdb_hwmodel.startswith('HP ')
  delegate_to: localhost
  register: results

- ansible.builtin.fail:
    msg: 'CMDB serial ({{ cmdb_serialno }}) does not match hardware serial ({{ results.hw_system_serial }}) !'
  when: cmdb_serialno != results.hw_system_serial

返回值 

常见的返回值记录在此处，以下是此模块特有的字段

键	描述
host_power_status 字符串在 community.general 3.5.0 中添加	主机的电源状态。将是 `ON`、`OFF` 和 `UNKNOWN` 之一。返回：始终示例： `"ON"`
hw_bios_date 字符串	BIOS 日期返回：始终示例： `"05/05/2011"`
hw_bios_version 字符串	BIOS 版本返回：始终示例： `"P68"`
hw_eth_ilo 字典	接口信息（对于 iLO 网络接口）返回：始终示例： `[{"macaddress": "00:11:22:33:44:BA"}, {"macaddress_dash": "00-11-22-33-44-BA"}]`
hw_ethX 字典	接口信息（对于每个接口）返回：始终示例： `[{"macaddress": "00:11:22:33:44:55", "macaddress_dash": "00-11-22-33-44-55"}]`
hw_product_name 字符串	产品名称返回：始终示例： `"ProLiant DL360 G7"`
hw_product_uuid 字符串	产品 UUID 返回：始终示例： `"ef50bac8-2845-40ff-81d9-675315501dac"`
hw_system_serial 字符串	系统序列号返回：始终示例： `"ABC12345D6"`
hw_uuid 字符串	硬件 UUID 返回：始终示例: `"123456ABC78901D2"`

作者

Dag Wieers (@dagwieers)