community.windows.win_defrag 模块 – 合并本地卷上的碎片文件

注意

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

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

要安装它，请使用：ansible-galaxy collection install community.windows。您需要其他要求才能使用此模块，请参阅要求了解详细信息。

要在剧本中使用它，请指定：community.windows.win_defrag。

概要 

查找并合并本地卷上的碎片文件，以提高系统性能。
有关 win_defrag 的更多信息，请访问：https://technet.microsoft.com/en-us/library/cc731650%28v%3Dws.11.aspx%29

要求 

执行此模块的主机需要满足以下要求。

defrag.exe

参数 

参数	注释
exclude_volumes 列表 / 元素=字符串	要从碎片整理中排除的驱动器盘符或挂载点路径的列表。
freespace_consolidation 布尔值	在指定的卷上执行可用空间合并。选项 `false` ← (默认) `true`
include_volumes 列表 / 元素=字符串	要进行碎片整理的卷的驱动器盘符或挂载点路径的列表。如果省略此参数，则将对所有卷（未排除的）进行碎片整理。
parallel 布尔值	在后台并行对每个卷执行操作。选项 `false` ← (默认) `true`
priority 字符串	以低优先级或正常优先级运行操作。选项 `"low"` ← (默认) `"normal"`

示例 

- name: Defragment all local volumes (in parallel)
  community.windows.win_defrag:
    parallel: true

- name: 'Defragment all local volumes, except C: and D:'
  community.windows.win_defrag:
    exclude_volumes: [C, D]

- name: 'Defragment volume D: with normal priority'
  community.windows.win_defrag:
    include_volumes: D
    priority: normal

- name: Consolidate free space (useful when reducing volumes)
  community.windows.win_defrag:
    freespace_consolidation: true

返回值 

常见的返回值记录在此处，以下是此模块特有的字段

键	描述
changed 布尔值	是否进行了任何更改。返回：始终示例： `true`
cmd 字符串	模块使用的完整命令行。返回：始终示例： `"defrag.exe /C /V"`
msg 字符串	失败时可能出现的错误消息。返回：失败示例： `"Command 'defrag.exe' not found in $env:PATH."`
rc 整数	命令的返回码。返回：始终示例： `0`
stderr 字符串	命令的错误输出。返回：始终
stdout 字符串	命令的标准输出。返回：始终示例： `"Success."`

作者

Dag Wieers (@dagwieers)