win_file – Создаёт, изменяет или удаляет файлы или каталоги
Новая версия с 1.9.2.
Описание
- Создаёт (пустые) файлы, обновляет метки времени изменения существующих файлов, а также может создавать или удалять каталоги.
- В отличие от модуля file, не изменяет права доступа, разрешения или ссылки.
- Для платформ, отличных от Windows, используйте модуль file.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| path path / обязательно | Путь к файлу, который необходимо обработать. псевдонимы: dest, name | |
| state - |
| Если directory, все непосредственные подкаталоги будут созданы, если они не существуют.Если file, файл НЕ будет создан, если он не существует; обратитесь к модулям copy или template, если вам нужно такое поведение. Если absent, каталоги будут рекурсивно удалены, а файлы — удалены.Если touch, будет создан пустой файл, если path не существует; в то же время существующий файл или каталог получат обновлённые временные метки доступа и изменения (похоже на работу touch из командной строки). |
Примечания
Примечание
Примеры
- 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]
- Этот модуль поддерживается основной командой Ansible. [core]
Поддержка Red Hat
Дополнительную информацию о поддержке этого модуля Red Hat можно найти в этой статье базы знаний 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.7/modules/win_file_module.html
