win_file – Создаёт, изменяет метки или удаляет файлы или каталоги

Описание
Параметры
См. также
Примеры
Статус

Описание

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

Параметры

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