community.windows.win_hotfix 模块 – 安装和卸载 Windows 热修复补丁

注意

此模块是 community.windows 集合（版本 2.3.0）的一部分。

如果您使用的是 ansible 包，则可能已经安装了此集合。它不包含在 ansible-core 中。要检查是否已安装，请运行 ansible-galaxy collection list。

要安装它，请使用：ansible-galaxy collection install community.windows。

要在 playbook 中使用它，请指定：community.windows.win_hotfix。

概要 

安装、卸载 Windows 热修复补丁。

参数 

参数	注释
hotfix_identifier 字符串	热修复补丁的名称，如 DISM 中所示，有关详细信息，请参阅示例。当 `state=absent` 时，必须设置此项或 `hotfix_kb`。如果 `state=present`，则将根据此值验证 `source` 上的热修复补丁，如果不匹配，则会发生错误。您可以通过在展开 msu 文件后运行“Get-WindowsPackage -Online -PackagePath path-to-cab-in-msu”来获取标识符。
hotfix_kb 字符串	热修复补丁相关的 KB 的名称，有关详细信息，请参阅示例。当 `state=absent` 时，必须设置此项或 `hotfix_identifier`。如果 `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 ADK https://developer.microsoft.com/zh-cn/windows/hardware/windows-assessment-deployment-kit 在 Windows 7 和 Server 2008 R2 上手动安装此模块，请参阅示例，了解如何使用 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 中添加	msu 中每个热修复补丁的 DISM 标识符。已返回：成功示例： `["Package_for_KB3172729~31bf3856ad364e35~amd64~~6.3.1.0"]`
kb 字符串	热修复补丁相关的 KB。已返回：成功示例： `"KB3172729"`
kbs 列表 / 元素=字符串在 community.windows 1.10.0 中添加	msu 中每个热修复补丁的 KB。已返回：成功示例： `["KB3172729"]`
reboot_required 字符串	是否需要重新启动才能完成安装或卸载。已返回：成功示例： `"True"`

作者

Jordan Borean (@jborean93)