win_updates - Загрузка и установка обновлений Windows
Новое в версии 2.0.
Обзор
- Выполняет поиск, загрузку и установку обновлений Windows синхронно, автоматизируя клиент Windows Update
Параметры
| параметр | обязательно | по умолчанию | варианты | комментарии |
|---|---|---|---|---|
| category_names |
нет | [u'CriticalUpdates', u'SecurityUpdates', u'UpdateRollups'] |
|
Скалярное значение или список категорий для установки обновлений |
| log_path |
нет | Если задано, win_updates будет добавлять информацию о прогрессе установки обновлений в указанный файл. Директория должна существовать. |
||
| state |
нет | installed |
|
Управляет тем, как находятся найденные обновления: выводятся в список или устанавливаются.
Этот модуль также поддерживает режим проверки Ansible, который имеет тот же эффект, что и установка state=searched |
Примеры
# Install all security, critical, and rollup updates
- win_updates:
category_names:
- SecurityUpdates
- CriticalUpdates
- UpdateRollups
# Install only security updates
- win_updates:
category_names: SecurityUpdates
# Search-only, return list of found updates (if any), log to c:\ansible_wu.txt
- win_updates:
category_names: SecurityUpdates
state: searched
log_path: c:\ansible_wu.txt
Возвращаемые значения
Общие возвращаемые значения описаны здесь Возвращаемые значения, следующие поля уникальны для этого модуля:
| имя | описание | возвращается | тип | пример | ||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| failed_update_count | Количество обновлений, которые не удалось установить |
всегда | int | 0 | ||||||||||||||||||||||||||||||
| found_update_count | Количество найденных обновлений, требующих применения |
успешно | int | 3 | ||||||||||||||||||||||||||||||
| installed_update_count | Количество успешно установленных обновлений |
успешно | int | 2 | ||||||||||||||||||||||||||||||
| reboot_required | True, когда для завершения установки обновлений требуется перезагрузка целевого сервера (дальнейшие обновления не могут быть установлены до перезагрузки). |
успешно | boolean | True | ||||||||||||||||||||||||||||||
| updates | Список обновлений, которые были найдены/установлены |
успешно | сложный | None | ||||||||||||||||||||||||||||||
| содержит: |
|
|||||||||||||||||||||||||||||||||
Примечания
Примечание
-
win_updatesдолжен выполняться пользователем, имеющим членство в локальной группе администраторов -
win_updatesбудет использовать конфигурированную по умолчанию службу обновлений для компьютера (Windows Update, Microsoft Update, WSUS и т. д.) -
win_updatesне управляет перезагрузкой, но сообщит, когда требуется перезагрузка, с помощью возвращаемого значения reboot_required. -
win_updatesможет занимать значительное время для завершения (часы, в некоторых случаях). Производительность зависит от многих факторов, включая версию ОС, количество обновлений, нагрузку на систему и нагрузку на сервер обновлений. -
win_updatesвыполняет модуль как запланированную задачу; эта задача настроена на запуск и продолжение работы даже если компьютер Windows переключится на питание от батареи. Это поведение было изменено начиная с Ansible 2.4. Ранее запланированная задача не запускалась при питании от батареи.
Статус
Этот модуль помечен как бета, что означает, что он не гарантирует обратную совместимость.
Информация о техническом обслуживании
Дополнительную информацию о поддержке этого модуля компанией 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_updates_module.html
