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–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/ansible/windows/win_file_module.html