win_hotfix - установка и удаление исправлений Windows

Новая в версии 2.4.

Обзор
Параметры
Примечания
Примеры
Возвращаемые значения
Статус
- Автор

Обзор

Установка, удаление исправления 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` ДОЛЖНО быть установлено.

Примечания

Примечание

Этот модуль должен запускаться на хосте с установленным модулем PowerShell DISM и версией 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.

Примеры

- name: install Windows ADK with DISM for Server 2008 R2
  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
  win_hotfix:
    source: C:\temp\windows8.1-kb3172729-x64_e8003822a7ef4705cbb65623b72fd3cec73fe222.msu
    state: present
  register: hotfix_install

- win_reboot:
  when: hotfix_install.reboot_required

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

- win_reboot:
  when: hotfix_install.reboot_required

- name: install hotfix validating Identifier
  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

- win_reboot:
  when: hotfix_install.reboot_required

- name: uninstall hotfix with Identifier
  win_hotfix:
    hotfix_identifier: Package_for_KB3172729~31bf3856ad364e35~amd64~~6.3.1.0
    state: absent
  register: hotfix_uninstall

- win_reboot:
  when: hotfix_uninstall.reboot_required

- name: uninstall hotfix with KB (not recommended)
  win_hotfix:
    hotfix_kb: KB3172729
    state: absent
  register: hotfix_uninstall

- win_reboot:
  when: hotfix_uninstall.reboot_required

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

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

Ключ	Возвращаемое значение	Описание
identifier str	успех	Идентификатор DISM для исправления. Пример: Package_for_KB3172729~31bf3856ad364e35~amd64~~6.3.1.0
kb str	успех	KB, к которому относится исправление. Пример: KB3172729
reboot_required str	успех	Требуется ли перезагрузка для завершения установки или удаления. Пример: 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.5/modules/win_hotfix_module.html