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, что означает, что разработчики гарантируют отсутствие несовместимых изменений интерфейса.
Техническое обслуживание
Этот модуль помечен как core, что означает, что он поддерживается командой Ansible Core. Подробнее см. Техническое обслуживание и поддержка модулей.
Список других модулей, поддерживаемых командой Ansible Core, см. здесь.
Поддержка
Дополнительную информацию о поддержке этого модуля компанией 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.6/modules/win_reboot_module.html
