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