dellemc.openmanage.ome_configuration_compliance_info 模块 – OpenManage Enterprise 中管理的设备的设备合规性报告

注意

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

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

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

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

dellemc.openmanage 3.2.0 中的新增功能

概要 

此模块允许生成特定设备或配置合规性基线中所有设备的合规性报告。

要求 

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

python >= 3.9.6

参数 

参数	注释
baseline 字符串 / 必需	已创建基线的名称。即使模板未与基线关联，也会生成合规性报告。
ca_path 路径 dellemc.openmanage 5.0.0 中新增	包含用于验证的 CA 证书的隐私增强邮件 (PEM) 文件。
device_id 整数	与 baseline 关联的目标设备的 ID。
device_service_tag 字符串	与 baseline 关联的目标设备的设备服务标签。 device_service_tag 与 device_id 互斥。
hostname 字符串 / 必需	OpenManage Enterprise IP 地址或主机名。
password 字符串	OpenManage Enterprise 密码。如果未提供密码，则使用环境变量 `OME_PASSWORD`。示例：export OME_PASSWORD=password
port 整数	OpenManage Enterprise HTTPS 端口。默认值： `443`
timeout 整数 dellemc.openmanage 5.0.0 中新增	以秒为单位的套接字级别超时。默认值： `30`
username 字符串	OpenManage Enterprise 用户名。如果未提供用户名，则使用环境变量 `OME_USERNAME`。示例：export OME_USERNAME=username
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，则使用环境变量 `OME_X_AUTH_TOKEN`。示例：export OME_X_AUTH_TOKEN=x_auth_token

注释 

注意

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

示例 

---
- name: Retrieve the compliance report of all of the devices in the specified configuration compliance baseline.
  dellemc.openmanage.ome_configuration_compliance_info:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    ca_path: "/path/to/ca_cert.pem"
    baseline: baseline_name

- name: Retrieve the compliance report for a specific device associated with the baseline using the device ID.
  dellemc.openmanage.ome_configuration_compliance_info:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    ca_path: "/path/to/ca_cert.pem"
    baseline: baseline_name
    device_id: 10001

- name: Retrieve the compliance report for a specific device associated with the baseline using the device service tag.
  dellemc.openmanage.ome_configuration_compliance_info:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    ca_path: "/path/to/ca_cert.pem"
    baseline: baseline_name
    device_service_tag: 2HFGH3

返回值 

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

键	描述
compliance_info 字典	返回合规性报告信息。返回：成功示例： [{"ComplianceAttributeGroups": [{"Attributes": [], "ComplianceReason": "目标设备的一个或多个属性与合规性模板不匹配。", "ComplianceStatus": 2, "ComplianceSubAttributeGroups": [{"Attributes": [{"AttributeId": 75369, "ComplianceReason": "属性的值与模板不同", "ComplianceStatus": 3, "CustomId": 0, "Description": null, "DisplayName": "工作负载配置文件", "ExpectedValue": "HpcProfile", "Value": "NotAvailable"}], "ComplianceReason": "目标设备的一个或多个属性与合规性模板不匹配。", "ComplianceStatus": 2, "ComplianceSubAttributeGroups": [], "DisplayName": "系统配置文件设置", "GroupNameId": 1}], "DisplayName": "BIOS", "GroupNameId": 1}], "ComplianceStatus": "NONCOMPLIANT", "DeviceName": "WIN-PLOV8MPIP40", "DeviceType": 1000, "Id": 25011, "InventoryTime": "2021-03-18 00:01:57.809771", "Model": "PowerEdge R7525", "ServiceTag": "JHMBX53"}]
error_info 字典	HTTP 错误的详细信息。返回：HTTP 错误时示例：`{"error": {"@Message.ExtendedInfo": [{"Message": "由于发生错误，无法处理请求。", "MessageArgs": [], "MessageId": "GEN1234", "RelatedProperties": [], "Resolution": "重试操作。如果问题仍然存在，请联系您的系统管理员。", "Severity": "Critical"}], "code": "Base.1.0.GeneralError", "message": "发生一般错误。请参阅 ExtendedInfo 获取更多信息。"} }`
消息字符串	整体合规性报告状态。返回：发生错误时示例：`"由于输入的目标基线名称“baseline”无效，无法完成操作。"`

作者

Felix Stephen A (@felixs88)
Kritika Bhateja (@Kritika-Bhateja)