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

Примечание

Этот модуль входит в состав коллекции community.windows (версия 2.3.0).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Для установки используйте: 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 path-to-cab-in-msu’ после распаковки файла msu.
hotfix_kb строка	Имя KB, к которому относится исправление. См. примеры для подробностей. Этот параметр или `hotfix_identifier` ОБЯЗАТЕЛЬНО должны быть установлены, когда `state=absent`. Если `state=present`, то исправление по адресу `source` будет проверено на соответствие этому значению. При несовпадении возникнет ошибка. Поскольку DISM использует идентификатор в качестве ключа и не всегда ссылается на KB, рекомендуется использовать `hotfix_identifier`.
source путь	Путь к скачанному файлу исправления .msu. Этот параметр ОБЯЗАТЕЛЬНО должен быть установлен, если `state=present`, и должен быть файлом исправления .msu.
state строка	Определяет, нужно ли установить или удалить исправление. Когда `present`, `source` ОБЯЗАТЕЛЬНО должен быть установлен. Когда `absent`, `hotfix_identifier` или `hotfix_kb` ОБЯЗАТЕЛЬНО должны быть установлены. Варианты: `"absent"` `"present"` ← (по умолчанию)

Примечания

Примечание

Модуль необходимо запускать на хосте, на котором установлен модуль 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_updates: Загрузка и установка обновлений Windows.

Примеры

- 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 строка	Идентификатор DISM для исправления. Возвращается: успех Пример: `"Package_for_KB3172729~31bf3856ad364e35~amd64~~6.3.1.0"`
identifiers список / элементы=строка добавлен в community.windows 1.10.0	Идентификаторы DISM для каждого исправления в файле msu. Возвращается: успех Пример: `["Package_for_KB3172729~31bf3856ad364e35~amd64~~6.3.1.0"]`
kb строка	KB, к которому относится исправление. Возвращается: успех Пример: `"KB3172729"`
kbs список / элементы=строка добавлен в community.windows 1.10.0	KB для каждого исправления в файле msu. Возвращается: успех Пример: `["KB3172729"]`
reboot_required строка	Требуется ли перезагрузка для завершения установки или удаления. Возвращается: успех Пример: `"True"`

Авторы

Jordan Borean (@jborean93)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/community/windows/win_hotfix_module.html