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

注意

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

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

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

要在剧本中使用它，请指定：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 版本。选项 `"SSLv3"` `"SSLv23"` `"TLSv1"` ← (默认) `"TLSv1_1"` `"TLSv1_2"`

属性 

属性	支持	描述
check_mode	支持：完全支持此操作不会修改状态。	可以在 `check_mode` 中运行，并在不修改目标的情况下返回更改状态预测。
diff_mode	支持： N/A 此操作不会修改状态。	在差异模式下，将返回有关已更改内容（或可能需要在 `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)