win_find - Return a list of files based on specific criteria

• Synopsis
• Parameters
• Examples
• Return Values
• Status
  • Author

Synopsis

• Return a list of files based on specified criteria.
• Multiple criteria are AND’d together.
• For non-Windows targets, use the find module instead.

Parameters

Examples

- name: Find files in path
  win_find:
    paths: D:\temp

- name: Find hidden files in path
  win_find:
    paths: D:\temp
    hidden: True

- name: Find files in multiple paths
  win_find:
    paths: ['C:\temp', 'D:\temp']

- name: Find files in directory while searching recursively
  win_find:
    paths: D:\temp
    recurse: True

- name: Find files in directory while following symlinks
  win_find:
    paths: D:\temp
    recurse: True
    follow: True

- name: Find files with .log and .out extension using powershell wildcards
  win_find:
    paths: D:\temp
    patterns: ['*.log', '*.out']

- name: Find files in path based on regex pattern
  win_find:
    paths: D:\temp
    patterns: 'out_\d{8}-\d{6}.log'

- name: Find files older than 1 day
  win_find:
    paths: D:\temp
    age: 86400

- name: Find files older than 1 day based on create time
  win_find:
    paths: D:\temp
    age: 86400
    age_stamp: ctime

- name: Find files older than 1 day with unit syntax
  win_find:
    paths: D:\temp
    age: 1d

- name: Find files newer than 1 hour
  win_find:
    paths: D:\temp
    age: -3600

- name: Find files newer than 1 hour with unit syntax
  win_find:
    paths: D:\temp
    age: -1h

- name: Find files larger than 1MB
  win_find:
    paths: D:\temp
    size: 1048576

- name: Find files larger than 1GB with unit syntax
  win_find:
    paths: D:\temp
    size: 1g

- name: Find files smaller than 1MB
  win_find:
    paths: D:\temp
    size: -1048576

- name: Find files smaller than 1GB with unit syntax
  win_find:
    paths: D:\temp
    size: -1g

- name: Find folders/symlinks in multiple paths
  win_find:
    paths: ['C:\temp', 'D:\temp']
    file_type: directory

- name: Find files and return SHA256 checksum of files found
  win_find:
    paths: C:\temp
    get_checksum: True
    checksum_algorithm: sha256

- name: Find files and do not return the checksum
  win_find:
    path: C:\temp
    get_checksum: False

Return Values

Common return values are documented here, the following are the fields unique to this module:

Status

This module is flagged as preview which means that it is not guaranteed to have a backwards compatible interface.

Author

• Jordan Borean (@jborean93)