win_reboot - Перезагрузка компьютера с Windows
Новая версия 2.1.
Обзор
- Перезагружает компьютер с Windows, ожидает его выключения, перезагрузки и готовности к командам.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| connect_timeout | Значение по умолчанию: 5 | Максимальное время (в секундах) ожидания успешного TCP-соединения с конечной точкой WinRM перед повторной попыткой Псевдонимы: connect_timeout_sec |
| msg | Значение по умолчанию: Перезагрузка инициирована Ansible | Сообщение для отображения пользователям |
| post_reboot_delay (добавлен в 2.4) | Значение по умолчанию: 0 | Время ожидания (в секундах) после успешной перезагрузки и повторного установления соединения. Полезно, если нужно подождать, пока что-то стабилизируется, несмотря на то, что соединение уже работает Псевдонимы: post_reboot_delay_sec |
| pre_reboot_delay | Значение по умолчанию: 2 | Время ожидания (в секундах) выключения перед запросом перезагрузки Псевдонимы: pre_reboot_delay_sec |
| reboot_timeout | Значение по умолчанию: 600 | Максимальное время ожидания (в секундах) появления компьютера в сети и отклика на тестовую команду. Это тайм-аут проверяется отдельно для появления в сети и успешного выполнения тестовой команды (поэтому максимальное время на практике вдвое больше). Псевдонимы: reboot_timeout_sec |
| shutdown_timeout | Значение по умолчанию: 600 | Максимальное время ожидания (в секундах) завершения выключения. Увеличьте этот тайм-аут для очень медленного оборудования, больших приложений обновлений и т.д. Этот параметр был удален с Ansible 2.5, так как поведение win_reboot изменилось. Псевдонимы: shutdown_timeout_sec |
| test_command | Значение по умолчанию: whoami | Команда, успешное выполнение которой указывает на готовность компьютера к управлению. |
Примечания
Примечание
- Если на системе уже запланировано выключение,
win_rebootотменит запланированное выключение и применит собственное выключение.
Примеры
# Unconditionally reboot the machine with all defaults
- win_reboot:
# Apply updates and reboot if necessary
- win_updates:
register: update_result
- win_reboot:
when: update_result.reboot_required
# Reboot a slow machine that might have lots of updates to apply
- win_reboot:
reboot_timeout: 3600
Значения возврата
Общие значения возврата описаны здесь, следующие поля уникальны для данного модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| elapsed int | всегда | Количество секунд, затраченное на ожидание перезагрузки системы. Пример: 23 |
| rebooted boolean | всегда | true, если компьютер был перезагружен Пример: True |
Статус
Этот модуль помечен как stableinterface, что означает, что разработчики гарантируют отсутствие несовместимых изменений интерфейса.
Поддержка
Дополнительную информацию о поддержке этого модуля Red Hat можно найти в этой статье базы знаний
Автор
- Matt Davis (@nitzmahone)
Подсказка
Если вы заметите какие-либо проблемы в данной документации, вы можете отредактировать этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.5/modules/win_reboot_module.html
