Table of Contents

Description

Recursively searches for files under a root path with optional multi-extension filtering (e.g. pdf, docx, txt).

Overview

Recursively searches for files under a given root path. Supports filtering by multiple file extensions in a single pass (e.g. pdf, docx, txt, xlsx) so operators can sweep for all file types of interest without running separate tasks.

Arguments

Parameter	Type	Default	Description
Path	string	C:\Users\	Root path to search.
Extensions	string[]	(all)	Extensions to match without the leading dot (e.g. `pdf`, `docx`, `txt`). Leave empty to return all files.
Recurse	bool	true	Recursively search all subdirectories.
FilesOnly	bool	true	Return only files, excluding directories.
MaxResults	int	500	Maximum results to return. 0 = unlimited.

Notes

Extension matching is case-insensitive and accepts extensions with or without the leading dot.
MaxResults prevents runaway output when searching broad paths without an extension filter.
Results are sorted newest-modified first.

Dependencies

None

Operating Systems

Windows
Linux
Mac

Example Output

[
  {
    "Length": 30216,
    "PSIsContainer": false,
    "Extension": ".pdf",
    "CreationTimeUtc": "2026-04-05T18:56:55.6342294Z",
    "LastAccessTimeUtc": "2026-04-05T18:56:55.6342294Z",
    "LastWriteTimeUtc": "2026-04-05T18:56:50Z",
    "FullName": "C:\\Users\\helpdesk\\Dropbox\\Finances\\Taxes\\2025\\Filing\\Submitted Screen.pdf"
  }
]