win_find - Возвращает список файлов по определённым критериям
Новая версия 2.3.
Описание
- Возвращает список файлов, соответствующих заданным критериям.
- Несколько критериев объединяются операцией «И».
- Для платформ, отличных от Windows, используйте модуль find.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| age | Выбирает файлы или папки, чей возраст равен или больше указанного времени. Используйте отрицательное значение для поиска файлов, чей возраст равен или меньше указанного времени. Вы можете выбрать секунды, минуты, часы, дни или недели, указав первую букву соответствующего слова (например, "2s", "10d", 1w"). | |
| age_stamp |
| Выберите свойство файла, с которым сравнивать age. По умолчанию сравнивается время последней модификации. |
| checksum_algorithm |
| Алгоритм определения контрольной суммы файла. Возбудит ошибку, если хост не поддерживает указанный алгоритм. |
| file_type |
| Тип файла для поиска. |
| follow bool |
| Установите yes, чтобы следовать символическим ссылкам в пути.Это необходимо использовать в сочетании с recurse. |
| get_checksum bool |
| Возвращать ли контрольную сумму файла в возвращаемой информации (по умолчанию sha1), используйте checksum_algorithm для изменения от значения по умолчанию. |
| hidden bool |
| Включить скрытые файлы или папки. |
| paths обязательно | Список путей к каталогам для поиска файлов или папок. Может быть указан как один путь или список путей. | |
| patterns | Один или несколько шаблонов (powershell или регулярные выражения) для сравнения имён файлов. Тип сопоставления шаблонов регулируется параметром use_regex. Шаблоны ограничивают список возвращаемых файлов или папок, основываясь на именах файлов. Для соответствия файла достаточно совпадения с одним шаблоном из предоставленного списка. | |
| recurse bool |
| Рекурсивно перебирает подкаталоги в поисках файлов или папок. |
| size | Выбирает файлы или папки, чей размер равен или больше указанного размера. Используйте отрицательное значение для поиска файлов, чей размер равен или меньше указанного размера. Размер можно указать с суффиксом типа байта, например, кило = k, мега = m... Размер не вычисляется для символических ссылок. | |
| use_regex bool |
| Установит шаблоны для работы как проверки с помощью регулярных выражений, если значение установлено 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