win_file - Creates, touches or removes files or directories

• Synopsis
• Parameters
• Notes
• Examples
• Status
• Maintenance
  • Support
  • Author

Synopsis

• Creates (empty) files, updates file modification stamps of existing files, and can create or remove directories.
• Unlike file, does not modify ownership, permissions or manipulate links.
• For non-Windows targets, use the file module instead.

Parameters

Notes

Examples

- 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

Status

This module is flagged as stableinterface which means that the maintainers for this module guarantee that no backward incompatible interface changes will be made.

Maintenance

This module is flagged as core which means that it is maintained by the Ansible Core Team. See Module Maintenance & Support for more info.

For a list of other modules that are also maintained by the Ansible Core Team, see here.

Support

For more information about Red Hat’s support of this module, please refer to this Knowledge Base article

Author

• Jon Hawkesworth (@jhawkesworth)