Модуль community.windows.win_defrag — объединение фрагментированных файлов на локальных томах

Примечание

Этот модуль входит в коллекцию community.windows (версия 3.1.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)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/community/windows/win_defrag_module.html