dellemc.openmanage.idrac_bios 角色 – 修改和清除 BIOS 属性，以及重置 BIOS 设置

注意

此角色是 dellemc.openmanage 集合（版本 9.9.0）的一部分。

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

要安装它，请使用：ansible-galaxy collection install dellemc.openmanage。

要在剧本中使用它，请指定：dellemc.openmanage.idrac_bios。

入口点 main – 修改和清除 BIOS 属性，以及重置 BIOS 设置

dellemc.openmanage 7.6.0 中的新增功能

概要

  • 此角色允许修改 BIOS 属性，清除挂起的 BIOS 属性，以及将 BIOS 重置为默认设置。

参数

参数

注释

apply_time

字符串

attributes 的应用时间。

这仅适用于 attributes。

Immediate 允许用户立即重启主机并应用更改。job_wait 适用。

OnReset 允许用户在下次重启主机服务器时应用更改。

AtMaintenanceWindowStart 允许用户在 maintenance_window 中指定的维护窗口开始时应用更改。将计划一个重启作业。

InMaintenanceWindowOnReset 允许在手动重置后但在 maintenance_window 中指定的维护窗口内应用更改。

选择

  • "Immediate" ← (默认)

  • "OnReset"

  • "AtMaintenanceWindowStart"

  • "InMaintenanceWindowOnReset"

attributes

字典

BIOS 属性和值对的字典。属性应是 Redfish Dell BIOS 属性注册表的一部分。使用 idrac_gather_facts 角色来获取 BIOS 属性。

这与 reset_bios 互斥。

ca_path

路径

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

clear_pending

布尔值

允许用户清除所有挂起的 BIOS 属性更改。

true 会丢弃对 BIOS 属性的任何挂起更改，或删除处于计划状态的作业。

此操作不会创建任何作业。

false 不执行任何操作。

这与 boot_sources、attributes 和 reset_bios 互斥。

Note 由于启动源配置，任何计划的 BIOS 作业都不会被清除。

选择

  • false

  • true

hostname

字符串 / 必需

iDRAC IP 地址。

https_port

整数

iDRAC 端口。

默认值： 443

https_timeout

整数

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

默认值： 30

job_wait

布尔值

提供等待作业完成的选项。

当 apply_time 为 Immediate 时，这适用于 attributes。

选择

  • false

  • true ← (默认)

job_wait_timeout

整数

job_wait 的最大等待时间（以秒为单位）。仅在此持续时间内跟踪作业。

当 job_wait 为 true 时，此选项适用。

默认值： 1200

maintenance_window

字典

用于计划维护窗口的选项。

当 apply_time 为 AtMaintenanceWindowStart 或 InMaintenanceWindowOnReset 时，这是必需的。

duration

整数 / 必需

维护窗口的持续时间（以秒为单位）。

start_time

字符串 / 必需

要计划的维护窗口的开始时间。

格式为 YYYY-MM-DDThh:mm:ss<offset>

<offset> 是当前 iDRAC 中设置的时区与 UTC 的时间偏移量，格式为：+05:30 for IST。

password

字符串

iDRAC 用户密码。

reset_bios

布尔值

将 BIOS 重置为默认设置，并触发主机系统重启。

这将在重启后应用于主机。

此操作不会创建任何作业。

false 不执行任何操作。

这与 boot_sources、attributes 和 clear_pending 互斥。

当 true 时，此操作将始终报告为发现存在适用的更改。

选择

  • false

  • true

reset_type

字符串

force_restart 强制重启主机系统。

graceful_restart 平缓重启主机系统。

这适用于 reset_bios 和 attributes，当 apply_time 为 Immediate 时。

选择

  • "graceful_restart" ← (默认)

  • "force_restart"

username

字符串

iDRAC 用户名。

validate_certs

布尔值

如果为 false，则不会验证 SSL 证书。

仅在个人控制的站点（使用自签名证书）上配置 false。

选择

  • false

  • true ← (默认)