модуль dellemc.openmanage.idrac_bios — изменение и очистка атрибутов BIOS, сброс настроек BIOS и настройка источников загрузки
Примечание
Этот модуль входит в коллекцию dellemc.openmanage (версия 10.0.2).
Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.
Для установки используйте: ansible-galaxy collection install dellemc.openmanage. Для использования этого модуля требуются дополнительные компоненты; подробности см. в разделе Требования.
Чтобы использовать модуль в плейбуке, укажите: dellemc.openmanage.idrac_bios.
Добавлено в dellemc.openmanage 2.1.0
Краткое описание
- Этот модуль позволяет изменять атрибуты BIOS. Также он очищает ожидающие применения атрибуты BIOS и сбрасывает настройки BIOS до значений по умолчанию.
- Источники загрузки можно включать и отключать. Можно настроить последовательность загрузки.
Требования
На хосте, выполняющем этот модуль, необходимы следующие компоненты.
- omsdk >= 1.2.490
- python >= 3.9.6
Параметры
Параметр | Комментарии |
|---|---|
apply_time string | Время применения атрибутов. Применимо только к атрибутам.
Варианты:
|
attributes dictionary | Словарь пар «атрибут BIOS — значение». Атрибуты должны присутствовать в реестре атрибутов Dell BIOS Redfish. URI Redfish можно просмотреть по адресу https://I(idrac_ip/redfish/v1/Systems/System.Embedded.1/Bios). Несовместим с параметрами boot_sources, clear_pending и reset_bios. |
boot_sources list / elements=any | (устарело) Список загрузочных устройств для настройки источников загрузки. boot_sources несовместим с параметрами attributes, clear_pending и reset_bios. Параметр job_wait неприменим. Модуль ожидает завершения этой задачи. Эта функция устарела. Для настройки источников загрузки используйте dellemc.openmanage.idrac_boot. |
ca_path path добавлено в dellemc.openmanage 5.0.0 | Файл Privacy Enhanced Mail (PEM), содержащий сертификат центра сертификации, который используется для проверки. |
clear_pending boolean | Позволяет пользователю очистить все ожидающие применения изменения атрибутов BIOS.
Эта операция не создает заданий.
Несовместим с параметрами boot_sources, attributes и reset_bios.
Варианты:
|
idrac_ip string / обязательный | IP-адрес iDRAC. |
idrac_password псевдонимы: idrac_pwd string / обязательный | Пароль пользователя iDRAC. Если пароль не указан, используется переменная среды Пример: export IDRAC_PASSWORD=password |
idrac_port integer | Порт iDRAC. По умолчанию: |
idrac_user string / обязательный | Имя пользователя iDRAC. Если имя пользователя не указано, используется переменная среды Пример: export IDRAC_USERNAME=username |
job_wait boolean | Позволяет ожидать завершения задания. Применимо к attributes, если значение apply_time — Варианты:
|
job_wait_timeout integer | Максимальное время ожидания для job_wait в секундах. Отслеживание задания выполняется только в течение этого времени. Этот параметр применяется, если job_wait имеет значение По умолчанию: |
maintenance_window dictionary | Параметры планирования окна обслуживания. Этот параметр обязателен, если значение apply_time — |
|
duration integer / обязательный |
Продолжительность окна обслуживания в секундах. |
|
start_time string / обязательный |
Время начала планируемого окна обслуживания. Формат: YYYY-MM-DDThh:mm:ss<offset> <offset> — смещение часового пояса, установленного в iDRAC, относительно UTC в формате +05:30 для IST. |
reset_bios boolean | Сбрасывает настройки BIOS до значений по умолчанию и инициирует перезагрузку хост-системы. Изменения применяются к хосту после перезагрузки. Эта операция не создает заданий.
Несовместим с параметрами boot_sources, attributes и clear_pending. Если Варианты:
|
reset_type string |
Применимо к reset_bios и attributes, если значение apply_time — Варианты:
|
string | (устарело) Локальный путь подключения сетевой папки с разрешениями на чтение и запись для пользователя ansible. Этот параметр обязателен для сетевых папок. |
string | (устарело) Сетевая папка или локальный путь. |
псевдонимы: share_pwd string | (устарело) Пароль пользователя сетевой папки. Этот параметр обязателен для папки CIFS. |
string | (устарело) Имя пользователя сетевой папки. Используйте формат ‘user@domain’ или domain//user, если пользователь входит в домен. Этот параметр обязателен для папки CIFS. |
timeout integer добавлено в dellemc.openmanage 5.0.0 | Тайм-аут на уровне сокета в секундах. По умолчанию: |
validate_certs boolean добавлено в dellemc.openmanage 5.0.0 | Если Устанавливайте В версиях коллекции до Варианты:
|
Примечания
Примечание
- Установить omsdk требуется только для операции boot_sources.
- Для использования этого модуля пользователю idrac_user необходимы права «Администратор».
- Запускайте этот модуль в системе, имеющей прямой доступ к Dell iDRAC.
- Этот модуль поддерживает адреса IPv4 и IPv6 для параметра idrac_ip.
- Этот модуль поддерживает
check_mode.
Примеры
---
- name: Configure generic attributes of the BIOS
dellemc.openmanage.idrac_bios:
idrac_ip: "192.168.0.1"
idrac_user: "user_name"
idrac_password: "user_password"
ca_path: "/path/to/ca_cert.pem"
attributes:
BootMode: "Bios"
OneTimeBootMode: "Enabled"
BootSeqRetry: "Enabled"
- name: Configure PXE generic attributes
dellemc.openmanage.idrac_bios:
idrac_ip: "192.168.0.1"
idrac_user: "user_name"
idrac_password: "user_password"
ca_path: "/path/to/ca_cert.pem"
attributes:
PxeDev1EnDis: "Enabled"
PxeDev1Protocol: "IPV4"
PxeDev1VlanEnDis: "Enabled"
PxeDev1VlanId: 1
PxeDev1Interface: "NIC.Embedded.1-1-1"
PxeDev1VlanPriority: 2
- name: Configure BIOS attributes at Maintenance window
dellemc.openmanage.idrac_bios:
idrac_ip: "192.168.0.1"
idrac_user: "user_name"
idrac_password: "user_password"
ca_path: "/path/to/ca_cert.pem"
apply_time: AtMaintenanceWindowStart
maintenance_window:
start_time: "2022-09-30T05:15:40-05:00"
duration: 600
attributes:
BootMode: "Bios"
OneTimeBootMode: "Enabled"
BootSeqRetry: "Enabled"
- name: Clear pending BIOS attributes
dellemc.openmanage.idrac_bios:
idrac_ip: "192.168.0.1"
idrac_user: "user_name"
idrac_password: "user_password"
ca_path: "/path/to/ca_cert.pem"
clear_pending: true
- name: Reset BIOS attributes to default settings.
dellemc.openmanage.idrac_bios:
idrac_ip: "192.168.0.1"
idrac_user: "user_name"
idrac_password: "user_password"
validate_certs: false
reset_bios: true
- name: Configure boot sources
dellemc.openmanage.idrac_bios:
idrac_ip: "192.168.0.1"
idrac_user: "user_name"
idrac_password: "user_password"
ca_path: "/path/to/ca_cert.pem"
boot_sources:
- Name: "NIC.Integrated.1-2-3"
Enabled: true
Index: 0
- name: Configure multiple boot sources
dellemc.openmanage.idrac_bios:
idrac_ip: "192.168.0.1"
idrac_user: "user_name"
idrac_password: "user_password"
ca_path: "/path/to/ca_cert.pem"
boot_sources:
- Name: "NIC.Integrated.1-1-1"
Enabled: true
Index: 0
- Name: "NIC.Integrated.2-2-2"
Enabled: true
Index: 1
- Name: "NIC.Integrated.3-3-3"
Enabled: true
Index: 2
- name: Configure boot sources - Enabling
dellemc.openmanage.idrac_bios:
idrac_ip: "192.168.0.1"
idrac_user: "user_name"
idrac_password: "user_password"
ca_path: "/path/to/ca_cert.pem"
boot_sources:
- Name: "NIC.Integrated.1-1-1"
Enabled: true
- name: Configure boot sources - Index
dellemc.openmanage.idrac_bios:
idrac_ip: "192.168.0.1"
idrac_user: "user_name"
idrac_password: "user_password"
ca_path: "/path/to/ca_cert.pem"
boot_sources:
- Name: "NIC.Integrated.1-1-1"
Index: 0
Возвращаемые значения
Общие возвращаемые значения описаны здесь; ниже перечислены поля, уникальные для этого модуля:
Ключ | Описание |
|---|---|
error_info dictionary | Сведения об ошибке HTTP. Возвращается: при ошибке HTTP Пример: |
invalid_attributes dictionary | Словарь переданных недопустимых атрибутов. Возвращается: при передаче недопустимых атрибутов или значений. Пример: |
msg dictionary | Состояние задания для boot_sources или состояние действия, выполненного с BIOS. Возвращается: при успешном выполнении Пример: |
status_msg string | Общий статус операции с BIOS. Возвращается: при успешном выполнении Пример: |
Ссылки на коллекцию
© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/dellemc/openmanage/idrac_bios_module.html