win_file - Создаёт, создаёт временные метки или удаляет файлы или каталоги.
Новая версия с 1.9.2.
Обзор
- Создаёт (пустые) файлы, обновляет метки изменения времени файлов существующих файлов и может создавать или удалять каталоги.
- В отличие от file, не изменяет права владения, разрешения или манипулирует ссылками.
- Для платформ, отличных от Windows, используйте модуль file.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| path обязательный | путь к файлу, который управляется. Псевдонимы: dest, name
псевдонимы: dest, name | |
| state |
| Если directory, все непосредственные подкаталоги будут созданы, если они не существуют. Если file, файл НЕ будет создан, если он не существует, см. модуль copy или template, если вам нужно такое поведение. Если absent, каталоги будут рекурсивно удалены, а файлы будут удалены. Если touch, будет создан пустой файл, если path не существует, а существующий файл или каталог получат обновлённые метки времени доступа и изменения файла (подобно тому, как работает touch из командной строки). |
Примечания
Примечание
- Для платформ, отличных от Windows, используйте модуль file.
- См. также win_copy, win_template, copy, template, assemble
Примеры
- name: Touch a file (creates if not present, updates modification time if present)
win_file:
path: C:\Temp\foo.conf
state: touch
- name: Remove a file, if present
win_file:
path: C:\Temp\foo.conf
state: absent
- name: Create directory structure
win_file:
path: C:\Temp\folder\subfolder
state: directory
- name: Remove directory structure
win_file:
path: C:\Temp
state: absent
Статус
Этот модуль помечен как stableinterface, что означает, что авторы этого модуля гарантируют, что не будут внесены несовместимые изменения в интерфейс.
Поддержка
Дополнительную информацию о поддержке этого модуля Red Hat см. в этой статье базы знаний
Автор
- Jon Hawkesworth (@jhawkesworth)
Подсказка
Если вы обнаружите какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.5/modules/win_file_module.html
