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

Значения возврата

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

Статус

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

Для получения помощи в разработке модулей, если вы так решите, ознакомьтесь с Информация о сообществе и вклад, Тестирование Ansible и Разработка модулей.