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.

См. также

win_package – Установка/удаление устанавливаемого пакета: Официальная документация по модулю win_package.
win_updates – Загрузка и установка обновлений Windows: Официальная документация по модулю win_updates.

Примеры

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