community.windows.win_file_compression – Изменение сжатия файлов и каталогов на разделах NTFS.
Примечание
Этот плагин входит в коллекцию community.windows (версия 1.2.0).
Для его установки используйте: ansible-galaxy collection install community.windows.
Для использования в книге задач укажите: community.windows.win_file_compression.
Обзор
- Этот модуль устанавливает атрибут сжатия для файлов и каталогов в файловой системе, поддерживающей эту функцию, например NTFS.
- Сжатие NTFS может использоваться для экономии дискового пространства.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| force логическое |
| Этот параметр имеет эффект только когда recurse равен true.Если true, проверит состояние сжатия всех подкаталогов и файлов и внесёт изменения, если какое-либо из них отличается от compressed.Если false, внесёт изменения только если состояние сжатия path отличается от compressed.Если структура каталогов сложная или содержит много файлов, рекомендуется установить этот параметр в false, чтобы не приходилось проверять каждый файл. |
| path путь / обязательный | Полный путь к файлу или каталогу, который нужно изменить. Путь должен существовать в файловой системе, поддерживающей сжатие, например NTFS. | |
| recurse логическое |
| Определяет, нужно ли рекурсивно применять изменения ко всем подкаталогам и файлам. Этот параметр имеет эффект только если path является каталогом. При значении false, применяется только к path.При значении true, применяется к path и всем подкаталогам и файлам. |
| state строка |
| Установите в present, чтобы убедиться, что path сжат.Установите в absent, чтобы убедиться, что path не сжат. |
Примечания
Примечание
- community.windows.win_file_compression устанавливает состояние сжатия файловой системы, а не создаёт архив zip.
- Подробнее о сжатии NTFS см. http://www.ntfs.com/ntfs-compressed.htm
Примеры
- name: Compress log files directory
community.windows.win_file_compression:
path: C:\Logs
state: present
- name: Decompress log files directory
community.windows.win_file_compression:
path: C:\Logs
state: absent
- name: Compress reports directory and all subdirectories
community.windows.win_file_compression:
path: C:\business\reports
state: present
recurse: yes
# This will only check C:\business\reports for the compressed state
# If C:\business\reports is compressed, it will not make a change
# even if one of the child items is uncompressed
- name: Compress reports directory and all subdirectories (quick)
community.windows.win_file_compression:
path: C:\business\reports
compressed: yes
recurse: yes
force: no
Возвращаемые значения
Общие возвращаемые значения описаны здесь, следующие поля уникальны для данного модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| rc целое число | всегда | Код возврата операции сжатия/распаковки. Если изменений не было или операция прошла успешно, rc равно 0. |
Авторы
- Micah Hunsberger (@mhunsber)
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/community/windows/win_file_compression_module.html
