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 |
| Выполняется установка или удаление исправления. Когда 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. Подробности см. в разделе Техническое обслуживание и поддержка модулей.
Список других модулей, которые также поддерживаются сообществом Ansible, см. здесь.
Автор
- 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.6/modules/win_hotfix_module.html
