Spec-Zone.ru › Ansible 2.6

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
bool
    Варианты:
  • no ←
  • yes
Установите yes, чтобы следовать символическим ссылкам в пути.
Это необходимо использовать в сочетании с recurse.
get_checksum
bool
    Варианты:
  • no
  • yes ←
Возвращать ли контрольную сумму файла в возвращаемой информации (по умолчанию sha1), используйте checksum_algorithm для изменения от значения по умолчанию.
hidden
bool
    Варианты:
  • no ←
  • yes
Включить скрытые файлы или папки.
paths
обязательно
Список путей к каталогам для поиска файлов или папок. Может быть указан как один путь или список путей.
patterns
Один или несколько шаблонов (powershell или регулярные выражения) для сравнения имён файлов. Тип сопоставления шаблонов регулируется параметром use_regex. Шаблоны ограничивают список возвращаемых файлов или папок, основываясь на именах файлов. Для соответствия файла достаточно совпадения с одним шаблоном из предоставленного списка.
recurse
bool
    Варианты:
  • no ←
  • yes
Рекурсивно перебирает подкаталоги в поисках файлов или папок.
size
Выбирает файлы или папки, чей размер равен или больше указанного размера. Используйте отрицательное значение для поиска файлов, чей размер равен или меньше указанного размера. Размер можно указать с суффиксом типа байта, например, кило = k, мега = m... Размер не вычисляется для символических ссылок.
use_regex
bool
    Варианты:
  • 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
int
всегда
Количество файлов/папок, которые были проверены

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

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

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

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

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

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

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

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

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

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

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

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

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

Пример:
1477984205.15
lnk_source
string
Цель символической ссылки, возвращает null, если это не ссылка или ссылка повреждена

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

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

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

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

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

Пример:
2


Статус

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

Техническое обслуживание

Этот модуль помечен как сообщество, что означает, что он поддерживается сообществом Ansible. Дополнительную информацию см. в разделе Техническое обслуживание и поддержка модулей.

Список других модулей, поддерживаемых сообществом 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.6/modules/win_find_module.html

Spec-Zone.ru

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