Spec-Zone.ru › Ansible 2.7

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

Новая версия 2.3.

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

Описание

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

Параметры

Параметр Варианты/Значения по умолчанию Комментарии
age
-
Выбирает файлы или папки, чей возраст равен или больше указанного времени. Используйте отрицательный возраст для поиска файлов, чей возраст равен или меньше указанного времени. Вы можете выбрать секунды, минуты, часы, дни или недели, указав первую букву соответствующего слова (например, "2s", "10d", 1w").
age_stamp
-
    Варианты:
  • atime
  • ctime
  • mtime ←
Выберите свойство файла, с которым мы сравниваем age. По умолчанию сравнивается время последней модификации.
checksum_algorithm
-
    Варианты:
  • md5
  • sha1 ←
  • sha256
  • sha384
  • sha512
Алгоритм для определения контрольной суммы файла. Вызовет ошибку, если хост не поддерживает указанный алгоритм.
file_type
-
    Варианты:
  • directory
  • file ←
Тип файла для поиска.
follow
boolean
    Варианты:
  • no ←
  • yes
Установите в yes для отслеживания символических ссылок в пути.
Это необходимо использовать вместе с recurse.
get_checksum
boolean
    Варианты:
  • no
  • yes ←
Нужно ли возвращать контрольную сумму файла в возвращаемой информации (по умолчанию sha1), используйте checksum_algorithm для изменения от значения по умолчанию.
hidden
boolean
    Варианты:
  • no ←
  • yes
Установите для включения скрытых файлов или папок.
paths
- / обязательно
Список путей к каталогам для поиска файлов или папок. Может быть указан как один путь или список путей.
patterns
-
Один или несколько шаблонов (PowerShell или регулярных выражений) для сравнения имён файлов. Тип сопоставления шаблонов контролируется параметром use_regex. Шаблоны сужают список возвращаемых файлов или папок на основе имён файлов. Для соответствия файлу достаточно совпадения с одним шаблоном из предоставленного списка.
recurse
boolean
    Варианты:
  • no ←
  • yes
Произведёт рекурсивный спуск по каталогам в поисках файлов или папок.
size
-
Выбирает файлы или папки, чей размер равен или больше указанного. Используйте отрицательное значение для поиска файлов, чей размер равен или меньше указанного. Размер можно указать с суффиксом типа байта, т.е. килобайт = k, мегабайт = m... Размер не оценивается для символических ссылок.
use_regex
boolean
    Варианты:
  • no ←
  • yes
Установит шаблоны для работы как проверки регулярных выражений, если значение установлено в yes.

Примеры

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

- name: Find hidden files in path
  win_find:
    paths: D:\Temp
    hidden: yes

- 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: yes

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

- 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: yes
    checksum_algorithm: sha256

- name: Find files and do not return the checksum
  win_find:
    paths: C:\Temp
    get_checksum: no

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

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

Ключ Возвращаемое значение Описание
examined
целое число
всегда
Количество файлов/папок, которые были проверены

Пример:
10
files
сложное
успех
Информация о файлах/папках, соответствующих критериям, возвращается в виде списка элементов словаря для каждого сопоставленного файла. Элементы отсортированы по пути в алфавитном порядке.

attributes
строка
успех, путь существует
Атрибуты файла по пути в сыром виде

Пример:
Архив, Скрытый
checksum
строка
успех, путь существует, путь является файлом, get_checksum == True
Хеш-сумма файла, основанная на указанном алгоритме checksum_algorithm

Пример:
09cb79e8fc7453c84a07f644e441fd81623b7f98
creationtime
вещественное число
успех, путь существует
Время создания файла, представленное в секундах с момента эпохи

Пример:
1477984205.15
extension
строка
успех, путь существует, путь является файлом
Расширение файла по пути

Пример:
.ps1
isarchive
логическое значение
успех, путь существует
Готов ли путь к архивированию

Пример:
True
isdir
логическое значение
успех, путь существует
Является ли путь каталогом

Пример:
True
ishidden
логическое значение
успех, путь существует
Является ли путь скрытым

Пример:
True
islnk
логическое значение
успех, путь существует
Является ли путь символической ссылкой или соединением

Пример:
True
isreadonly
логическое значение
успех, путь существует
Только чтение или нет

Пример:
True
isshared
логическое значение
успех, путь существует
Общий ресурс или нет

Пример:
True
lastaccesstime
вещественное число
успех, путь существует
Время последнего доступа к файлу, представленное в секундах с момента эпохи

Пример:
1477984205.15
lastwritetime
вещественное число
успех, путь существует
Время последнего изменения файла, представленное в секундах с момента эпохи

Пример:
1477984205.15
lnk_source
строка
Целевой объект символической ссылки, вернёт null, если это не ссылка или ссылка недействительна

Пример:
C:\temp
owner
строка
успех, путь существует
Владелец файла

Пример:
BUILTIN\Administrators
path
строка
успех, путь существует
Полный абсолютный путь к файлу

Пример:
BUILTIN\Administrators
sharename
строка
успех, путь существует, путь является каталогом и isshared == True
Имя общего ресурса, если папка общая

Пример:
file-share
size
целое число
успех, путь существует, путь не является ссылкой
Размер файла или папки в байтах

Пример:
1024
matched
целое число
всегда
Количество файлов/папок, соответствующих критериям

Пример:
2


Статус

  • Данный модуль не гарантирует обратную совместимость. [превью]
  • Этот модуль поддерживается сообществом Ansible. [сообщество]

Авторы

  • Jordan Borean (@jborean93)

Подсказка

Если вы обнаружите какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.7/modules/win_find_module.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API