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

Примечание

Этот плагин входит в коллекцию ansible.windows (версия 1.3.0).

Для его установки используйте: ansible-galaxy collection install ansible.windows.

Для использования в плейбуке укажите: ansible.windows.win_file.

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

Описание

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

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
path путь / обязательный		Путь к управляемому файлу. Псевдонимы: dest, name
state строка	Варианты: absent directory file touch	Если `directory`, все непосредственные подкаталоги будут созданы, если они не существуют. Если `file`, файл НЕ будет создан, если он не существует. См. модули ansible.windows.win_copy или ansible.windows.win_template, если вам нужно такое поведение. Если `absent`, каталоги будут рекурсивно удалены, а файлы - удалены. Если `touch`, пустой файл будет создан, если `path` не существует, в то время как существующий файл или каталог получат обновлённые временные метки доступа и изменения (похожим образом, как работает `touch` из командной строки).

См. также

ansible.builtin.file: Официальная документация модуля ansible.builtin.file.
ansible.windows.win_acl: Официальная документация модуля ansible.windows.win_acl.
ansible.windows.win_acl_inheritance: Официальная документация модуля ansible.windows.win_acl_inheritance.
ansible.windows.win_owner: Официальная документация модуля ansible.windows.win_owner.
ansible.windows.win_stat: Официальная документация модуля ansible.windows.win_stat.

Примеры

- name: Touch a file (creates if not present, updates modification time if present)
  ansible.windows.win_file:
    path: C:\Temp\foo.conf
    state: touch

- name: Remove a file, if present
  ansible.windows.win_file:
    path: C:\Temp\foo.conf
    state: absent

- name: Create directory structure
  ansible.windows.win_file:
    path: C:\Temp\folder\subfolder
    state: directory

- name: Remove directory structure
  ansible.windows.win_file:
    path: C:\Temp
    state: absent

Авторы

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.10/collections/ansible/windows/win_file_module.html