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–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/community/windows/win_file_compression_module.html
