Documentation

win_defrag - Consolidate fragmented files on local volumes.

New in version 2.4.

Synopsis

Options

parameter required default choices comments
excluded_volumes
no
A list of drive letters or mount point paths to exclude from defragmentation.
freespace_consolidation
no
Perform free space consolidation on the specified volumes.
included_volumes
no
A list of drive letters or mount point paths of the volumes to be defragmented.
If this parameter is omitted, all volumes (not excluded) will be fragmented.
parallel
no no
  • yes
  • no
Run the operation on each volume in parallel in the background.
priority
no low
  • low
  • normal
Run the operation at low or normal priority.

Examples

- name: Defragment all local volumes (in parallel)
  win_defrag:
    parallel: yes

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

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

- name: Consolidate free space (useful when reducing volumes)
  win_defrag:
    freespace_consolidation: yes

Return Values

Common return values are documented here Return Values, the following are the fields unique to this module:

name description returned type sample
cmd
The complete command line used by the module
always string defrag.exe /C /V
stderr
The error output from the command
always string None
stdout
The standard output from the command
always string Success.
msg
Possible error message on failure
failed string Command 'defrag.exe' not found in $env:PATH.
changed
Whether or not any changes were made.
always bool True
rc
The return code for the command
always int 0


Status

This module is flagged as preview which means that it is not guaranteed to have a backwards compatible interface.

For help in developing on modules, should you be so inclined, please read Community Information & Contributing, Testing Ansible and Developing Modules.