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–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/community/windows/win_hotfix_module.html