W3cubDocs

/Ansible 2.9

win_defrag – Consolidate fragmented files on local volumes

New in version 2.4.

Synopsis
Requirements
Parameters
Examples
Return Values
Status

Synopsis

Locates and consolidates fragmented files on local volumes to improve system performance.
More information regarding win_defrag is available from: https://technet.microsoft.com/en-us/library/cc731650(v=ws.11.aspx)

Requirements

The below requirements are needed on the host that executes this module.

defrag.exe

Parameters

Parameter	Choices/Defaults	Comments
exclude_volumes list		A list of drive letters or mount point paths to exclude from defragmentation.
freespace_consolidation boolean	Choices: no ← yes	Perform free space consolidation on the specified volumes.
include_volumes list		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 boolean	Choices: no ← yes	Run the operation on each volume in parallel in the background.
priority string	Choices: 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, the following are the fields unique to this module:

Key	Returned	Description
changed boolean	always	Whether or not any changes were made. Sample: True
cmd string	always	The complete command line used by the module. Sample: defrag.exe /C /V
msg string	failed	Possible error message on failure. Sample: Command 'defrag.exe' not found in $env:PATH.
rc integer	always	The return code for the command.
stderr string	always	The error output from the command.
stdout string	always	The standard output from the command. Sample: Success.

Status

This module is not guaranteed to have a backwards compatible interface. [preview]
This module is maintained by the Ansible Community. [community]

Authors

Dag Wieers (@dagwieers)

Hint

If you notice any issues in this documentation, you can edit this document to improve it.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.9/modules/win_defrag_module.html