win_reboot — Перезагрузка компьютера Windows
Новая версия с 2.1.
Описание
- Перезагрузка компьютера Windows, ожидание его выключения, включения и готовности к командам.
Параметры
| Параметр | Обязателен | Значение по умолчанию | Варианты | Комментарии |
|---|---|---|---|---|
| connect_timeout | нет | 5 | Максимальное время ожидания успешного TCP-соединения с конечной точкой WinRM перед повторной попыткой (в секундах) Псевдонимы: connect_timeout_sec | |
| msg | нет | Перезагрузка инициирована Ansible | Сообщение для отображения пользователям | |
| post_reboot_delay (добавлен в 2.4)
| нет | Время ожидания (в секундах) после успешной перезагрузки и восстановления соединения. Это полезно, если нужно дождаться завершения каких-либо процессов, несмотря на то, что соединение уже работает. Псевдонимы: post_reboot_delay_sec | ||
| pre_reboot_delay | нет | 2 | Время ожидания выключения (в секундах) перед запросом перезагрузки Псевдонимы: pre_reboot_delay_sec | |
| reboot_timeout | нет | 600 | Максимальное время ожидания появления компьютера в сети и отклика на тестовую команду (в секундах). Это время ожидания оценивается отдельно как для появления в сети, так и для успешного выполнения тестовой команды (максимальное реальное время — в два раза больше). Псевдонимы: reboot_timeout_sec | |
| shutdown_timeout | нет | 600 | Максимальное время ожидания завершения выключения (в секундах). Увеличьте это время ожидания для медленного оборудования, крупных приложений обновления и т. д. Псевдонимы: shutdown_timeout_sec | |
| test_command | нет | whoami | Команда, успешное выполнение которой подтвердит готовность компьютера к управлению. |
Примеры
# 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:
shutdown_timeout: 3600
reboot_timeout: 3600
Возвращаемые значения
Общие возвращаемые значения описаны здесь Возвращаемые значения, следующие — уникальные для данного модуля:
| Имя | Описание | Возвращается | Тип | Пример |
|---|---|---|---|---|
| elapsed | Количество секунд, затраченных на ожидание перезагрузки системы. | всегда | int | 23 |
| rebooted | true, если компьютер был перезагружен | всегда | boolean | True |
Примечания
Примечание
- Если на системе уже запланировано выключение,
win_rebootотменит запланированное выключение и выполнит собственное.
Статус
Этот модуль помечен как stableinterface, что означает, что разработчики гарантируют отсутствие несовместимых изменений интерфейса.
Информация о техническом обслуживании
Дополнительную информацию о поддержке этого модуля компанией Red Hat см. в knowledge base article<https://access.redhat.com/articles/rhel-top-support-policies>
Для получения помощи в разработке модулей обратитесь к Справочной информации по сообществу и участию, Тестирование Ansible и Разработка модулей.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.4/win_reboot_module.html
