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` ОБОЯЗАТЕЛЬНО должен быть задан.

Примечания

Примечание

Модуль должен запускаться на хосте, на котором установлен модуль 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.

Примеры

- 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 строка	успех	Идентификатор исправления DISM. Пример: Package_for_KB3172729~31bf3856ad364e35~amd64~~6.3.1.0
kb строка	успех	KB, к которому относится исправление. Пример: KB3172729
reboot_required строка	успех	Требуется ли перезагрузка для завершения установки или удаления. Пример: True

Статус

Интерфейс этого модуля не гарантируется как обратно совместимый. [превью]
Этот модуль поддерживается сообществом Ansible. [community]

Авторы

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.7/modules/win_hotfix_module.html