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 |
| Установка или удаление исправления. При present, source ДОЛЖНО быть задано.При absent, hotfix_identifier или hotfix_kb ДОЛЖНО быть задано. |
Примеры
- 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 для исправления. | успех | str | Package_for_KB3172729~31bf3856ad364e35~amd64~~6.3.1.0 |
| kb | KB, к которому относится исправление. | успех | str | KB3172729 |
| reboot_required | Требуется ли перезагрузка для завершения установки или удаления. | успех | str | True |
Примечания
Примечание
- Данный модуль должен запускаться на хосте с установленным модулем 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 и Разработка модулей.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.4/win_hotfix_module.html
