ansible.windows.win_updates – Загрузка и установка обновлений Windows

Примечание

Этот плагин входит в состав коллекции ansible.windows (версия 1.3.0).

Для его установки используйте: ansible-galaxy collection install ansible.windows.

Для использования в книге задач укажите: ansible.windows.win_updates.

Обзор
Параметры
Примечания
См. также
Примеры
Значения возврата

Обзор

Синхронно находит, загружает и устанавливает обновления Windows, автоматизируя клиент Windows Update.

Примечание

У данного модуля есть соответствующий плагин действий.

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
blacklist список / элементы=строка		Список названий обновлений или номеров KB, которые можно использовать для указания обновлений, которые следует исключить из установки. Если доступное обновление соответствует одному из элементов, оно пропускается и не устанавливается. Каждый элемент может быть статьёй KB или названием обновления в качестве регулярного выражения в соответствии с правилами регулярных выражений PowerShell.
category_names список / элементы=строка	По умолчанию: ["CriticalUpdates", "SecurityUpdates", "UpdateRollups"]	Скаляр или список категорий для установки обновлений. Чтобы получить список категорий, запустите модуль с `state=searched`. Категория должна быть полной строкой категории, но регистронезависима. Некоторые возможные категории: Приложения, Коннекторы, Критические обновления, Обновления определений, Наборы инструментов разработчиков, Пакеты функций, Руководства, Обновления безопасности, Сервис-паки, Инструменты, Сводки обновлений и Обновления.
log_path путь		Если установлено, `win_updates` будет добавлять прогресс обновления в указанный файл. Каталог должен уже существовать.
reboot булево	Варианты: нет ← да	Ansible автоматически перезагрузит удаленный хост, если это необходимо, и продолжит установку обновлений после перезагрузки. Это можно использовать вместо использования задачи ansible.windows.win_reboot после этой и гарантирует, что все обновления для данной категории установятся за один раз. Асинхронная работа не работает, когда `reboot=yes`.
reboot_timeout строка	По умолчанию: 1200	Время в секундах, в течение которого будет ожидать, пока хост вернётся онлайн после перезагрузки. Это используется только если `reboot=yes`, и требуется перезагрузка.
server_selection строка	Варианты: по умолчанию ← managed_server windows_update	Определяет каталог источника Windows Update. `default` Используйте исходный каталог по умолчанию. Для многих систем по умолчанию установлен каталог каталога Microsoft Windows Update. Системы, участвующие в Windows Server Update Services (WSUS), Systems Center Configuration Manager (SCCM) или аналогичных корпоративных серверах обновления, могут использовать по умолчанию эти управляемые источники обновлений вместо каталога Windows Update. `managed_server` Используйте каталог управляемого сервера. Для сред, использующих Windows Server Update Services (WSUS), Systems Center Configuration Manager (SCCM) или аналогичные корпоративные серверы обновлений, этот параметр выбирает определённый корпоративный источник обновления. `windows_update` Используйте каталог каталога Microsoft Windows Update.
state строка	Варианты: установлено ← поиск скачано	Управляет тем, загружаются ли найденные обновления или устанавливаются, или перечисляются Этот модуль также поддерживает режим проверки Ansible, который имеет тот же эффект, что и установка state=searched
use_scheduled_task булево	Варианты: нет ← да	Не будет автоматически повышать привилегии удалённого процесса с помощью become и вместо этого будет использовать запланированную задачу. Установите это в `yes`, когда используете этот модуль с асинхронным режимом на Server 2008, 2008 R2 или Windows 7 или на Server 2008, который не аутентифицирован с помощью базовой или credssp. Также может быть установлено в `yes`, на более новых хостах, где become не работает из-за дополнительных ограничений привилегий по умолчанию ОС.
whitelist список / элементы=строка		Список названий обновлений или номеров KB, которые могут использоваться для указания обновлений, которые должны быть найдены или установлены. Если доступное обновление не соответствует ни одному из элементов, оно пропускается и не устанавливается. Каждый элемент может быть статьёй KB или названием обновления в качестве регулярного выражения в соответствии с правилами регулярных выражений PowerShell. Белый список проверяется только для обновлений, которые были найдены на основе category_names. Он не будет заставлять модуль устанавливать обновление, если оно не было в указанной категории.

Примечания

Примечание

ansible.windows.win_updates должен выполняться пользователем, входящим в локальную группу Administrators.
ansible.windows.win_updates будет использовать конфигурированную по умолчанию службу обновлений для машины (Windows Update, Microsoft Update, WSUS и т. д.).
ansible.windows.win_updates будет повышать привилегии до SYSTEM с помощью runas, если use_scheduled_task равно yes.
По умолчанию ansible.windows.win_updates не управляет перезагрузками, но сообщит, когда перезагрузка требуется, с помощью возвращаемого значения reboot_required. reboot может использоваться для перезагрузки хоста, если это требуется в одной задаче.
ansible.windows.win_updates может потребовать значительного времени для завершения (часы в некоторых случаях). Производительность зависит от многих факторов, включая версию ОС, количество обновлений, загрузку системы и загрузку сервера обновлений.
Обратите внимание, что сразу после перезагрузки системы ansible.windows.win_updates система Windows может ещё не стабилизироваться, и некоторые базовые службы могут быть в подвешенном состоянии. Это может привести к непредвиденному поведению. Обратитесь к примерам для способов уменьшения этого.
Дополнительную информацию о PowerShell и том, как он обрабатывает строки RegEx, можно найти по адресу https://technet.microsoft.com/en-us/library/2007.11.powershell.aspx.

См. также

chocolatey.chocolatey.win_chocolatey: Официальная документация модуля chocolatey.chocolatey.win_chocolatey.
ansible.windows.win_feature: Официальная документация модуля ansible.windows.win_feature.
community.windows.win_hotfix: Официальная документация модуля community.windows.win_hotfix.
ansible.windows.win_package: Официальная документация модуля ansible.windows.win_package.

Примеры

- name: Install all security, critical, and rollup updates without a scheduled task
  ansible.windows.win_updates:
    category_names:
      - SecurityUpdates
      - CriticalUpdates
      - UpdateRollups

- name: Install only security updates as a scheduled task for Server 2008
  ansible.windows.win_updates:
    category_names: SecurityUpdates
    use_scheduled_task: yes

- name: Search-only, return list of found updates (if any), log to C:\ansible_wu.txt
  ansible.windows.win_updates:
    category_names: SecurityUpdates
    state: searched
    log_path: C:\ansible_wu.txt

- name: Install all security updates with automatic reboots
  ansible.windows.win_updates:
    category_names:
    - SecurityUpdates
    reboot: yes

- name: Install only particular updates based on the KB numbers
  ansible.windows.win_updates:
    category_name:
    - SecurityUpdates
    whitelist:
    - KB4056892
    - KB4073117

- name: Exclude updates based on the update title
  ansible.windows.win_updates:
    category_name:
    - SecurityUpdates
    - CriticalUpdates
    blacklist:
    - Windows Malicious Software Removal Tool for Windows
    - \d{4}-\d{2} Cumulative Update for Windows Server 2016

# One way to ensure the system is reliable just after a reboot, is to set WinRM to a delayed startup
- name: Ensure WinRM starts when the system has settled and is ready to work reliably
  ansible.windows.win_service:
    name: WinRM
    start_mode: delayed

# Optionally, you can increase the reboot_timeout to survive long updates during reboot
- name: Ensure we wait long enough for the updates to be applied during reboot
  ansible.windows.win_updates:
    reboot: yes
    reboot_timeout: 3600

# Search and download Windows updates
- name: Search and download Windows updates without installing them
  ansible.windows.win_updates:
    state: downloaded

Значения возврата

Общие значения возврата описаны здесь, следующие являются полями, уникальными для этого модуля:

Ключ		Возвращаемое значение	Описание
failed_update_count целое число		всегда	Количество обновлений, которые не удалось установить.
filtered_updates сложное		успех	Список обновлений, которые были найдены, но были отфильтрованы на основе чёрного списка, белого списка или названий категорий. Значение возврата имеет тот же формат, что и updates, а также filtered_reason. Пример: см. значение возврата updates
	filtered_reason строка	всегда	Причина, по которой это обновление было отфильтровано. Пример: skip_hidden
found_update_count целое число		успех	Количество найденных обновлений, требующих применения. Пример: 3
installed_update_count целое число		успех	Количество обновлений, успешно установленных или загруженных. Пример: 2
reboot_required логический		успех	Истинно, когда целевой сервер требует перезагрузки для завершения обновлений (никакие дальнейшие обновления не могут быть установлены до перезагрузки). Пример: True
updates сложное		успех	Список обновлений, которые были найдены/установлены.
	categories список / элементы=строка	всегда	Список строк категорий для этого обновления. Пример: ['Критические обновления', 'Windows Server 2012 R2']
	failure_hresult_code логический	при ошибке установки	Код HRESULT от неудачного обновления. Пример: 2147942402
	id строка	всегда	Внутренний GUID обновления Windows. Пример: fb95c1c8-de23-4089-ae29-fd3351d55421
	installed логический	всегда	Было ли обновление успешно установлено. Пример: True
	kb список / элементы=строка	всегда	Список идентификаторов статей KB, которые относятся к обновлению. Пример: ['3004365']
	title строка	всегда	Имя для отображения. Пример: Обновление системы безопасности для Windows Server 2012 R2 (KB3004365)

Авторы

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.10/collections/ansible/windows/win_updates_module.html