dellemc.openmanage.omevv_firmware_compliance_info 模块 – 获取固件合规性报告。

注意

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

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

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

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

dellemc.openmanage 9.9.0 中的新增功能

概要

  • 此模块允许您检索集群所有主机、集群的特定主机或多个集群的固件合规性报告。

要求

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

  • python >= 3.9.6

参数

参数

注释

ca_path

路径

包含用于验证的 CA 证书的隐私增强邮件 (PEM) 文件。

clusters

列表 / 元素=字典

用于检索固件合规性报告的集群详细信息。

cluster_name

字符串 / 必需

应检索固件合规性报告的主机的集群名称。

如果提供了 *servicetags* 或 *hosts*，则仅检索和显示指定主机的固件合规性报告。

hosts

列表 / 元素=字符串

必须检索固件合规性报告的主机的 IP 地址或主机名。

servicetags

列表 / 元素=字符串

必须检索固件合规性报告的主机的服务标签。

hostname

字符串 / 必需

OpenManage Enterprise Modular 的 IP 地址或主机名。

port

整数

OpenManage Enterprise HTTPS 端口。

默认值： 443

timeout

整数

套接字级别超时（以秒为单位）。

默认值： 30

validate_certs

布尔值

是否检查 SSL 证书。- 如果为 true，则将验证 SSL 证书。- 如果为 false，则不会验证 SSL 证书。

选项

  • false

  • true ← (默认值)

vcenter_password

字符串

用于 VMware vCenter 的 OpenManage Enterprise 集成 (OMEVV) 的密码。

如果未提供密码，则使用环境变量 OMEVV_VCENTER_PASSWORD。

示例：export OMEVV_VCENTER_PASSWORD=password

vcenter_username

字符串

用于 VMware vCenter 的 OpenManage Enterprise 集成 (OMEVV) 的用户名。

如果未提供用户名，则使用环境变量 OMEVV_VCENTER_USERNAME。

示例：export OMEVV_VCENTER_USERNAME=username

vcenter_uuid

字符串

vCenter 的通用唯一标识符 (UUID)。

可以使用 dellemc.openmanage.omevv_vcenter_info 模块检索 vCenter UUID 详细信息。

如果未提供 UUID，则使用环境变量 OMEVV_VCENTER_UUID。

示例：export OMEVV_VCENTER_UUID=uuid

属性

属性

支持

描述

check_mode

支持：完全支持

运行任务以验证，而无需对目标机器执行操作。

diff_mode

支持：完全支持

运行任务以报告所做的更改或必须应用的更改。

备注

注意

  • 从此模块可以直接访问 Dell OpenManage Enterprise 的系统运行此模块。

示例

---
- name: Retrieve a firmware compliance report of all the clusters
  dellemc.openmanage.omevv_firmware_compliance_info:
    hostname: "192.168.0.1"
    vcenter_uuid: "xxxxx"
    vcenter_username: "username"
    vcenter_password: "password"
    ca_path: "path/to/ca_file"

- name: Retrieve a firmware compliance report of all the hosts in a specific cluster
  dellemc.openmanage.omevv_firmware_compliance_info:
    hostname: "192.168.0.1"
    vcenter_uuid: "xxxxx"
    vcenter_username: "username"
    vcenter_password: "password"
    ca_path: "path/to/ca_file"
    clusters:
      - cluster_name: cluster_a

- name: Retrieve a firmware compliance report of specific hosts in the cluster
  dellemc.openmanage.omevv_firmware_compliance_info:
    hostname: "192.168.0.1"
    vcenter_uuid: "xxxxx"
    vcenter_username: "username"
    vcenter_password: "password"
    ca_path: "path/to/ca_file"
    clusters:
      - cluster_name: cluster_a
        servicetags:
          - SVCTAG1
          - SVCTAG2
        hosts:
          - host1
          - xx.xx.xx.xx

- name: Retrieve a firmware compliance report of multiple clusters
  dellemc.openmanage.omevv_firmware_compliance_info:
    hostname: "192.168.0.1"
    vcenter_uuid: "xxxxx"
    vcenter_username: "username"
    vcenter_password: "password"
    ca_path: "path/to/ca_file"
    clusters:
      - cluster_name: cluster_a
      - cluster_name: cluster_b

返回值

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

键

描述

firmware_compliance_info

列表 / 元素=字典

合规性报告的详细信息。

返回：HTTP 错误时

示例： [{"cluster": "cluster_a", "complianceStatus": "NonCompliant", "hostComplianceReports": [{"complianceStatus": "WARNING", "componentCompliances": [{"baselineValue": "4303A19", "complianceStatus": "WARNING", "componentName": "Enterprise UEFI Diagnostics", "criticality": "Optional", "currentValue": "4303A15", "driftStatus": "NonCompliant", "rebootRequired": false, "sourceName": "DCIM:INSTALLED#802__Diagnostics.Embedded.1:LC.Embedded.1", "updateAction": "UPGRADE"}], "deviceModel": "PowerEdge R660xs", "hostAddress": "XX.XX.XX.XX", "hostId": 1002, "serviceTag": "SVCTAG"}]}]

msg

字符串

检索固件合规性报告。

返回：始终

示例： "Successfully fetched the firmware compliance report."

作者

  • Abhishek Sinha(@ABHISHEK-SINHA10)