community.windows.win_hotfix – Установка и удаление обновлений Windows

Примечание

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

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

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

Описание
Параметры
Примечания
См. также
Примеры
Возвращаемые значения

Описание

Установка и удаление исправления Windows.

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
hotfix_identifier строка		Имя исправления, отображаемое в DISM, см. примеры для подробностей. Это или `hotfix_kb` ДОЛЖНО быть установлено, когда `state=absent` Если `state=present`, то исправление по адресу `source` будет проверено на соответствие этому значению, в противном случае произойдет ошибка. Вы можете получить идентификатор, выполнив 'Get-WindowsPackage -Online -PackagePath путь-к-файлу-cab-в-msu' после распаковки файла msu.
hotfix_kb строка		Название KB, к которому относится исправление, см. примеры для подробностей. Это или `hotfix_identifier` ДОЛЖНО быть установлено, когда `state=absent` Если `state=present`, то исправление по адресу `source` будет проверено на соответствие этому значению, в противном случае произойдет ошибка. Поскольку DISM использует идентификатор в качестве ключа и не ссылается на KB во всех случаях, рекомендуется использовать `hotfix_identifier` вместо.
source путь		Путь к загруженному файлу исправления .msu. Это ОБОЯЗАТЕЛЬНО должно быть установлено, если `state=present`, и ДОЛЖНО быть файлом исправления .msu.
state строка	Варианты: absent present ←	Необходимо ли установить или удалить исправление. Когда `present`, `source` ДОЛЖНО быть установлено. Когда `absent`, `hotfix_identifier` или `hotfix_kb` ДОЛЖНЫ быть установлены.

Примечания

Примечание

Этот модуль должен запускаться на узле с установленным модулем DISM PowerShell и версией PowerShell ≥ 4.
Этот модуль устанавливается по умолчанию в Windows 8 и Server 2012 и более поздних версиях.
Вы можете вручную установить этот модуль в Windows 7 и Server 2008 R2, установив Windows ADK https://developer.microsoft.com/en-us/windows/hardware/windows-assessment-deployment-kit, см. примеры, чтобы увидеть, как это сделать с помощью Chocolatey.
Вы можете загрузить исправления с https://www.catalog.update.microsoft.com/Home.aspx.

См. также

ansible.windows.win_package: Официальная документация по модулю ansible.windows.win_package.
ansible.windows.win_updates: Официальная документация по модулю ansible.windows.win_updates.

Примеры

- name: Install Windows ADK with DISM for Server 2008 R2
  chocolatey.chocolatey.win_chocolatey:
    name: windows-adk
    version: 8.100.26866.0
    state: present
    install_args: /features OptionId.DeploymentTools

- name: Install hotfix without validating the KB and Identifier
  community.windows.win_hotfix:
    source: C:\temp\windows8.1-kb3172729-x64_e8003822a7ef4705cbb65623b72fd3cec73fe222.msu
    state: present
  register: hotfix_install

- ansible.windows.win_reboot:
  when: hotfix_install.reboot_required

- name: Install hotfix validating KB
  community.windows.win_hotfix:
    hotfix_kb: KB3172729
    source: C:\temp\windows8.1-kb3172729-x64_e8003822a7ef4705cbb65623b72fd3cec73fe222.msu
    state: present
  register: hotfix_install

- ansible.windows.win_reboot:
  when: hotfix_install.reboot_required

- name: Install hotfix validating Identifier
  community.windows.win_hotfix:
    hotfix_identifier: Package_for_KB3172729~31bf3856ad364e35~amd64~~6.3.1.0
    source: C:\temp\windows8.1-kb3172729-x64_e8003822a7ef4705cbb65623b72fd3cec73fe222.msu
    state: present
  register: hotfix_install

- ansible.windows.win_reboot:
  when: hotfix_install.reboot_required

- name: Uninstall hotfix with Identifier
  community.windows.win_hotfix:
    hotfix_identifier: Package_for_KB3172729~31bf3856ad364e35~amd64~~6.3.1.0
    state: absent
  register: hotfix_uninstall

- ansible.windows.win_reboot:
  when: hotfix_uninstall.reboot_required

- name: Uninstall hotfix with KB (not recommended)
  community.windows.win_hotfix:
    hotfix_kb: KB3172729
    state: absent
  register: hotfix_uninstall

- ansible.windows.win_reboot:
  when: hotfix_uninstall.reboot_required

Возвращаемые значения

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

Ключ	Возвращаемое значение	Описание
identifier строка	success	Идентификатор DISM для исправления. Пример: Package_for_KB3172729~31bf3856ad364e35~amd64~~6.3.1.0
kb строка	success	KB, к которому относится исправление. Пример: KB3172729
reboot_required строка	success	Требуется ли перезагрузка для завершения установки или удаления. Пример: True

Авторы

Jordan Borean (@jborean93)

© 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/community/windows/win_hotfix_module.html