win_find — Возвращает список файлов по определённым критериям

• Описание
• Параметры
• Примеры
• Возвращаемые значения
• Статус
  • Автор

Описание

• Возвращает список файлов, соответствующих заданным критериям.
• Несколько критериев объединяются операцией И.
• Для платформ, отличных от Windows, используйте модуль find.

Параметры

Примеры

- 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

Возвращаемые значения

Общие возвращаемые значения описаны в документации, ниже приведены поля, уникальные для данного модуля:

Статус

Этот модуль помечен как превью, что означает, что интерфейс не гарантированно будет обратной совместимостью.

Автор

• Jordan Borean (@jborean93)