forfiles

<h2 id="usage">Usage</h2>
<p>The forfiles command has several <a href="/facts/Switch_(command_line)/R9JpGmXQ">command-line switches</a>.  If no switches or parameters given, it outputs the name of every file in the <a href="/facts/Working_directory/2qI00r0z">current directory</a>.
</p>
<h3>Switches</h3>
<table><tbody><tr><th>Switch</th><th>Argument</th><th>Meaning</th></tr><tr><td>/P</td><td>pathname</td><td>The <a href="/facts/Directory_(computing)/VLtLcEXY">directory</a> (folder) to search for files in.  The default is the current directory.  <a href="/facts/UNC_path/F5wNAuMY">UNC paths</a> (\\machine\share) are not accepted.</td></tr><tr><td>/M</td><td>searchmask</td><td>A <a href="/facts/Glob_(programming)/IIPcqW8o">glob pattern</a> (wildcard search).  Only files whose <a href="/facts/Filename/EGc4tA7n">filename</a> matches the pattern are selected.  The file extension is included in the filename; the path (folder name) is not.  The pattern must match the entire name, or use wildcards.  The default is to match all files.<p>This option treats glob patterns *.* and * differently.  The former will only match files with a dot in their name, while the latter will match even those with no dot or extension.  Most DOS/Windows commands will match files with no extension even when given a *.* pattern.</p></td></tr><tr><td>/S</td><td>(none)</td><td>Selects matching files in subdirectories.  By default, only the single, specified directory is searched.</td></tr><tr><td>/C</td><td>command</td><td>Execute the given command for each matching file.  The command string typically needs to be wrapped in double quotes.  See below for the syntax within the command string.  The default command is CMD /C ECHO @FILE, which causes the name of each matching file to be output (displayed).</td></tr><tr><td>/D</td><td>date</td><td>Selects files based on their last modified date.  See below for date syntax.  By default, files are selected regardless of their date.</td></tr><tr><td>/?</td><td>(none)</td><td>Displays a <a href="/facts/Online_help/dAzE62xs">help message</a> (brief usage instructions).  Suppresses file search/command execution.  May not be used with any other switch.</td></tr></tbody></table>
<h3>Command syntax</h3>
<p>The command string is executed as given, except as noted below.
</p><p>Sequences of the form 0xFF, where "0x" is literal, and "FF" represents any two-digit <a href="/facts/Hexadecimal/02ohQW22">hexadecimal</a> number, are replaced with the corresponding single-byte value.  This can be used to embed non-printing <a href="/facts/ASCII/vGUI33Qu">ASCII</a> characters, or <a href="/facts/Extended_ASCII/Agfdo1R0">extended ASCII</a> characters.
</p><p>The sequence \" is replaced with a literal quotation mark ".  Using the 0x sequence form described previously, 0x22 can also be used, which additionally hides the " from the command interpreter.
</p><p>Several <a href="/facts/Variable_(computer_science)/VoCKtwml">variables</a> are provided, to be used in the command as placeholders for the values from each file.  Variables are technically not required, but must be used if the command is to vary for each file.
</p>
<table><tbody><tr><th>Variable</th><th>Meaning</th></tr><tr><td>@file</td><td>The name of the matching item, double quoted.</td></tr><tr><td>@fname</td><td>The basename of the matching item (without file extension), double quoted.</td></tr><tr><td>@ext</td><td>The file extension, double quoted, without leading dot.  If a file has multiple extensions, only the last is returned.  If the file has no extension, a quoted empty string is returned.</td></tr><tr><td>@path</td><td>Full path of the matching item, double quoted, including drive letter, and file extension (if any).</td></tr><tr><td>@relpath</td><td>Path of the matching item, double quoted, and relative to the starting directory (given by /P).  Each path begins with a dot and backslash (.\).</td></tr><tr><td>@isdir</td><td>Evaluates to the literal string TRUE if the matching item is a directory, or FALSE if not.</td></tr><tr><td>@fsize</td><td>Size of the matching item, in <a href="/facts/Byte/BNHUp9Qq">bytes</a>.  Directories report a size of zero.</td></tr><tr><td>@fdate</td><td>Date the file was last modified, in the localized date format of the current user.</td></tr><tr><td>@ftime</td><td>Time the file was last modified, in the localized time format of the current user.</td></tr></tbody></table>
<h3>Date syntax</h3>
<p>The date switch (/D) selects files based on their last modified date, given a <i>date</i> argument.
</p><p>The date argument can be given as a literal date, in MM/DD/YYYY format (other date formats are not accepted).  Alternatively, the date argument can be given as a number, in which case it is taken to mean an age in days (i.e., the day <i>date</i> days before the present date).
</p><p>If the <i>date</i> argument begins with a minus (-), only files modified on or before the given date are selected (older file / modified earlier).  Otherwise, only files modified on or after the given date are selected (younger files / modified later).  An explicit plus (+) may be given, but is the default.  Note that both modes select files on the given date.  There is no way to select files only on a given date (without also either before or after).
</p>
<h2 id="examples">Examples</h2>
<p>The following command selects all log files (*.LOG) in the Windows directory 30 days or older, and lists them with their date.
</p>
C:\>FORFILES /P C:\Windows /M *.LOG /D -30 /C "CMD /C ECHO @FDATE @FILE"
6/12/2015 "iis7.log"
5/28/2015 "msxml4-KB954430-enu.LOG"
5/28/2015 "msxml4-KB973688-enu.LOG"
5/26/2015 "setuperr.log"

<p>The following command would delete the same files.
</p>
C:\>FORFILES /P C:\Windows /M *.LOG /D -30 /C "CMD /C DEL @PATH"

<p>The use of CMD /C is required in the above  examples, as both <a href="/facts/Echo_(command)/ue5jH01X">ECHO</a> and <a href="/facts/Del_(command)/8wLW0H0k">DEL</a> are internal to the <a href="/facts/Cmd.exe/FUmTvew6">command processor</a>, rather than external utility programs.
</p>
<h2 id="see-also">See also</h2>
<ul><li><a href="/facts/Cmd.exe/FUmTvew6">cmd.exe</a> – The program implementing the Windows command-line interpreter</li>
<li><a href="/facts/Foreach_loop/wQzIwX3k">Foreach loop</a> – The FOR and FORFILES commands both implement a <i>for-each loop</i></li>
<li><a href="/facts/Find_(Unix)/bg18ASlI">find (Unix)</a> – Unix command that finds files by attribute, similar to forfiles</li>
<li><a href="/facts/Find_(Windows)/YVFoxeRQ">find (Windows)</a> – DOS and Windows command that finds text matching a pattern</li>
<li><a href="/facts/Grep/PdGQeFfD">grep</a> – Unix command that finds text matching a pattern, similar to Windows find</li></ul>
<h2 id="further-reading">Further reading</h2>
<ul><li>"FORFILES", <i>Microsoft Windows</i> (Computer software), 6.1.7600.16385, Microsoft, 13 July 2009.</li>
<li><a href="https://technet.microsoft.com/en-us/library/cc753551.aspx">"Forfiles"</a>. <i>TechNet</i>. Microsoft. April 17, 2012. Retrieved 28 April 2016.</li>
<li>Simon Sheppard. <a href="https://ss64.com/nt/forfiles.html">"FORFILES.exe"</a>. <i>SS64</i>. Retrieved 28 April 2016.</li></ul>

<h2 id="external-links">External links</h2>

Wikibooks has a book on the topic of: <i>Guide to Windows Commands</i>

<ul><li><a href="https://docs.microsoft.com/en-us/windows-server/administration/windows-commands/forfiles">forfiles | Microsoft Docs</a></li></ul>

<h2 id="references">References</h2>

<ol>
<li id="fn:1"><p>"Forfiles.exe - Windows 98 Resource Kit Utility". Archived from the original on 2020-01-11. Retrieved 2020-01-11. <a href="https://web.archive.org/web/20200111203651/https://www.activexperts.com/admin/reskit/reskit98/forfiles/" target="_blank">https://web.archive.org/web/20200111203651/https://www.activexperts.com/admin/reskit/reskit98/forfiles/</a> <a href="#fnref:1" class="footnote-back-ref">↩</a></p></li>
<li id="fn:2"><p>Forfiles.exe - Windows 2000 Resource Kit Utility <a href="https://www.activexperts.com/admin/reskit/reskit2000/forfiles/" target="_blank">https://www.activexperts.com/admin/reskit/reskit2000/forfiles/</a> <a href="#fnref:2" class="footnote-back-ref">↩</a></p></li>
</ol>

forfiles open-in-new

forfiles