win_file - Создаёт, создаёт метки времени или удаляет файлы или каталоги.

Новая версия 1.9.2.

Обзор
Параметры
Примеры
Примечания
- Статус
- Информация о техническом обслуживании

Обзор

Создаёт (пустые) файлы, обновляет метки времени изменения существующих файлов и может создавать или удалять каталоги.
В отличие от file, не изменяет владение, разрешения или не манипулирует ссылками.
Для платформ, отличных от Windows, используйте модуль file.

Параметры

параметр	обязательно	значение по умолчанию	выбор	комментарии
path	да			путь к файлу, который обрабатывается. Псевдонимы: dest, name псевдонимы: dest, name
state	нет		file каталог touch absent	Если `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

Примечания

Примечание

Для платформ, отличных от Windows, используйте модуль file.
См. также win_copy, win_template, copy, template, assemble

Статус

Этот модуль помечен как stableinterface, что означает, что поддерживающие этот модуль разработчики гарантируют, что не будут вноситься изменения в интерфейс, несовместимые со старыми версиями.

Информация о техническом обслуживании

Для получения дополнительной информации о поддержке этого модуля компанией Red Hat, обратитесь к knowledge base article<https://access.redhat.com/articles/rhel-top-support-policies>

Для помощи в разработке модулей, если вы заинтересованы, прочитайте Информация о сообществе и вклад, Тестирование Ansible и Разработка модулей.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.4/win_file_module.html