Saturday, August 8, 2009

Unix / Linux find equivalent in Powershell Find-ChildItem Cmdlet

Find is one of the most often used commands in day to day work life. Unix find command provides lot of features and options that enable users to find files/directories more effectively

In Powershell, we can use Get-ChildItem cmdlet to search for files. But it doesn't give you all the fun. So I have developed Find-ChildItem Powershell cmdlet which is equivalent to Unix find command.

Download Find-ChildItem for both 32 bits and 64 bits

Note: For 64 bit operating system, you will have to use different InstallUtil.exe. See below for details

Find-ChildItem [-Name <String>] [-Type <String>] [-MaxDepth <Int32>] [-MinDepth <Int32>] [-CMin <String>]
[-AMin <String>] [-WMin <String>] [-CTime <String>] [-ATime <String>] [-WTime <String>] [-Size <String>]
[-Empty] [-Exec <String>] [-Delete] [-OutObject] [[-Path] <String>] [<CommonParameters>]

NameAccepts .Net regular expression to match FileName
Typed - directory, f - file
MaxDepthDescend at most levels (a non-negative integer) levels of directories below the command line arguments
MinDepthDo not apply any tests or actions at levels less than specified mindepth level (a non-negative integer)
CMinFile was created n minutes ago
CTimeFile was created n*24 hours ago
AMinFile was last accessed n minutes ago
ATimeFile was last accessed n*24 hours ago
WMinFile was last changed/written n minutes ago
WTimeFile was last changed/written n*24 hours ago
SizeFile uses n units of space
EmptyFile is empty
ExecExecute Cmdlets in the given argument.
DeleteDelete file or directory
OutObjectWrite Objects in output instead of just Directory/File Names

Find-ChildItem Cmdlet Installation Instructions:
  1. Extract files to C:\Windows\Microsoft.NET\Framework\ Directory
  2. Open Powershell with Administrator Privileges
  3. Now, lets install the cmdlet using InstallUtil.exe utility which is available as part of Microsoft Windows SDK.

    For 32 Bit Operating System:
    C:\Windows\Microsoft.NET\Framework\v2.0.50727\InstallUtil.exe "C:\Windows\Microsoft.NET\
    For 64 Bit Operating System:
    C:\Windows\Microsoft.NET\Framework64\v2.0.50727\InstallUtil.exe "C:\Windows\Microsoft.NET\
  4. Type Get-PSSnapin -Registered and press enter. If it displays FindChildItemPSSnapIn01 SnapIn, then our installation is successful
  5. Now, before we can use Find-ChildItem Cmdlet, we need to add FindChildItemPSSnapIn01 using Add-PSSnapin FindChildItemPSSnapIn01
  6. To permanently add the Snapin, Add-PSSnapin FindChildItemPSSnapIn01 Cmdlet need to be added to Windows Powershell Profile file
  7. See the below window, to get clear picture on Cmdlet Installation on Windows 7 32 Bits

PS C:\Users\Jagadish\> cd "C:\Windows\Microsoft.NET\Framework"
PS C:\Windows\Microsoft.NET\Framework> Get-ChildItem .\Find-ChildItem*

Directory: C:\Windows\Microsoft.NET\Framework

Mode LastWriteTime Length Name
---- ------------- ------ ----
-a--- 6/8/2009 1:13 PM 12288 Find-ChildItem.dll
-a--- 6/8/2009 1:14 PM 21298 Find-ChildItem.dll-Help.xml

PS C:\Windows\Microsoft.NET\Framework> C:\Windows\Microsoft.NET\Framework\v2.0.50727\InstallUtil.exe .\Find-ChildItem.dll
Microsoft (R) .NET Framework Installation utility Version 2.0.50727.3521
Copyright (c) Microsoft Corporation. All rights reserved.

Running a transacted installation.
The Commit phase completed successfully.

The transacted install has completed.

PS C:\Windows\Microsoft.NET\Framework> Get-PSSnapin -Registered

Name : FindChildItemPSSnapIn01
PSVersion : 2.0
Description : This is Powershell SnapIn that includes Find-ChildItem Cmdlet, developed by Jagadish <>

PS C:\Windows\Microsoft.NET\Framework> Add-PSSnapin FindChildItemPSSnapIn01

PS C:\Windows\Microsoft.NET\Framework> Find-ChildItem G:\Jagadish\Cmdlets

If you don't have windows powershell profile file, follow the below steps to create a new one and add "Add-PSSnapin FindChildItemPSSnapIn01" entry to it

PS C:\Users\Jagadish\Desktop\Find-ChildItem> New-Item $profile -ItemType file -Force ; Write-Output "Add-PSSnapin FindChildItemPSSnapIn01" > $profile

Directory: C:\Users\Jagadish\Documents\WindowsPowerShell

Mode LastWriteTime Length Name
---- ------------- ------ ----
-a--- 6/8/2009 6:28 PM 0 Microsoft.PowerShell_profile.ps1

That's it. You added the Add-Snapin entry permanently. Now, Lets have some fun with new Find-ChildItem Cmdlet

List all the files and directories in the current directory

PS G:\Jagadish\Test> Find-ChildItem
G:\Jagadish\Test\Songs\Green Day
G:\Jagadish\Test\Songs\Green Day\American Idiot- Boulevard Of Broken Dreams.mp3
PS G:\Jagadish\Test>

List ".exe" files only

PS G:\Jagadish\Test> Find-ChildItem -Type f -Name ".*.exe"
PS G:\Jagadish\Test>

Search for ".c" files only and display no of lines, words, characters in that file

PS G:\Jagadish\Test> Find-ChildItem -Type f -Name "\.c$" -Exec "Get-Content {} | Measure-Object -Line -Character -Word"

Lines Words Characters Property
----- ----- ---------- --------
162 500 3703

PS G:\Jagadish\Test>

You can use the below command to find Empty files in a directory and its sub directories

PS E:\Jagadish\Test> Find-ChildItem -Type f -Empty

Use -OutObject parameter to write file objects to powershell

PS E:\Jagadish\Test> Find-ChildItem -Type f -Empty -OutObject

Directory: Microsoft.PowerShell.Core\FileSystem::E:\Jagadish\Test\Docs

Mode LastWriteTime Length Name
---- ------------- ------ ----
-a--- 8/11/2009 10:16 PM 0 Attachment
-a--- 8/11/2009 10:16 PM 0 Report.txt
-a--- 8/11/2009 10:16 PM 0 sample_logs

Directory: Microsoft.PowerShell.Core\FileSystem::E:\Jagadish\Test

Mode LastWriteTime Length Name
---- ------------- ------ ----
-a--- 8/11/2009 10:16 PM 0 testing

Now, If we want to delete all the empty files, we can easily do that with the help of Find-ChildItem cmdlet
Find-ChildItem -Type f -Empty -Delete

PS E:\Jagadish\Test> Find-ChildItem -Type f -Empty -Delete
PS E:\Jagadish\Test> Find-ChildItem -Type f -Empty -OutObject
PS E:\Jagadish\Test>

Now, list all the files with size greater than 9 MB

PS E:\Jagadish\Test> Find-ChildItem -Type f -Size +9M -OutObject

Directory: Microsoft.PowerShell.Core\FileSystem::E:\Jagadish\Test\Downloads\VLC

Mode LastWriteTime Length Name
---- ------------- ------ ----
-a--- 12/13/2006 3:26 PM 9451515 vlc-0.8.6-win32.exe
-a--- 1/25/2007 3:00 PM 81510400 vlc-binary-fc4.tar.gz
-a--- 7/7/2006 5:46 PM 15680081 vlc-binary.tar.gz
-a--- 11/8/2006 5:45 PM 12461262 vlc_src-0.8.5.tar.gz

Directory: Microsoft.PowerShell.Core\FileSystem::E:\Jagadish\Test\Downloads

Mode LastWriteTime Length Name
---- ------------- ------ ----
-a--- 11/9/2006 7:24 PM 11348769 ethereal-setup-0.10.13.exe

If you want more details and usage information on this Find-ChildItem Cmdlet, type Get-Help Find-ChildItem -Full in your Powershell

Let me know if you need any other information or if you encounter any bugs/issues with Find-ChildItem Cmdlet


  1. Incredible tutorial..You explained everything in very detailed with good examples. This is what I was searching. There are lot of doubts that I cleared through this blog..Thank you very much !

  2. I think i am here by chance, but it is a good luck to me. I was trying to find some latest stuff from google and by chance I am here.

  3. Hi Jagadish, would i be able to use this command to find files from remote systems as well ? or would this work only on a single system?

    Would love to hear back form you asap.

  4. Jay,

    Yep, it works with remote systems as well!

  5. I stumbled upon this and really like it. I have added it to my computer and will continue to use it as long as I use PowerShell. I like it so much that I posted a link to this page on my blog!

    Thanks so much!

  6. Nice tool, and really good documentation. I do however frequently stumble upon this error quite often :

    At line:1 char:15
    + Find-ChildItem <<<< -Name "putty.exe"
    + CategoryInfo : NotSpecified: (:) [Find-ChildItem], PathTooLongException
    + FullyQualifiedErrorId : System.IO.PathTooLongException,Microsoft.Powershell.Commands.FindChildItemCommand

  7. Hello,

    I have this error during my commandline : $results = (Find-ChildItem $LetterMap -Type f -size +9M -outobject )

    Find-ChildItem : The specified network name is no longer available.

    But the directory stay online.

  8. Do you have this for PS version 3.0?

  9. It looks like the dll is compiled for win8, as it loads api-ms-win-appmodel-runtime-L1-1-0.dll, which is not present on windows 7. No luck for us, win7 users.

  10. Hello,

    i have 2 problems with this very good add-on.

    I have a script with more than 400lines like this
    Find-ChildItem \\NUFS011\MIPS\Nutrac\n_vera4\result2 -Name 0102617* -Exec "mv -path {} -destination \\NUFS010\MIPSARCH\Nutrac\saved_Tags\0102\010261\0102617";
    Find-ChildItem \\NUFS011\MIPS\Nutrac\n_vera4\result2 -Name 0102618* -Exec "mv -path {} -destination \\NUFS010\MIPSARCH\Nutrac\saved_Tags\0102\010261\0102618";
    Find-ChildItem \\NUFS011\MIPS\Nutrac\n_vera4\result2 -Name 0102619* -Exec "mv -path {} -destination \\NUFS010\MIPSARCH\Nutrac\saved_Tags\0102\010261\0102619";
    Find-ChildItem \\NUFS011\MIPS\Nutrac\n_vera4\result2 -Name 0102620* -Exec "mv -path {} -destination \\NUFS010\MIPSARCH\Nutrac\saved_Tags\0102\010262\0102620";
    the script works but the destination after moving Files are wrong. All Files are moved into one Directory.

    If the Destination File are exist, it was replaced with the new File. I need all File the old and the new one. Have you any Idea about this ?

    Best Regards

  11. For a basic find equiv. you could try
    (Get-ChildItem -Recurse | Where-Object {$_.Name -match "^Search" }).FullName
    with match we can use RegEx in the search and this example would look for a names of files recursively that would start with Search and then it would print the full path to the screen (just like find). If I want to modify the search type, just change the contents of the where-object statement.
    Hope this is useful.

  12. Doesn't work on Win 8.1 either. Sorry for the german. I can't change my PS to english.
    Add-PSSnapin : Das Windows PowerShell-Snap-In "FindChildItemPSSnapIn01" kann aufgrund des folgenden
    Fehlers nicht geladen werden: Die Datei oder Assembly
    "file:///C:\Windows\Microsoft.NET\Framework\Find-ChildItem.dll" oder eine Abhängigkeit davon wurde
    nicht gefunden. Der Vorgang wird nicht unterstützt. (Ausnahme von HRESULT: 0x80131515).
    In Zeile:1 Zeichen:1
    + Add-PSSnapin FindChildItemPSSnapIn01
    + ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
    + CategoryInfo : InvalidData: (FindChildItemPSSnapIn01:String) [Add-PSSnapin], PSSnapIn
    + FullyQualifiedErrorId : AddPSSnapInRead,Microsoft.PowerShell.Commands.AddPSSnapinCommand

    1. I am also seeing this in Windows 8.1 when I get to step 5.

      C:\Windows\Microsoft.NET\Framework\Find-ChildItem.dll definitely exists on my system.

      Here is the output:

      § AMyers-LT-W8 {~} Add-PSSnapin FindChildItemPSSnapIn01
      Add-PSSnapin : Cannot load Windows PowerShell snap-in FindChildItemPSSnapIn01 because of the following
      error: Could not load file or assembly 'file:///C:\Windows\Microsoft.NET\Framework\Find-ChildItem.dll' or
      one of its dependencies. Operation is not supported. (Exception from HRESULT: 0x80131515)
      At line:1 char:1
      + Add-PSSnapin FindChildItemPSSnapIn01
      + ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
      + CategoryInfo : InvalidData: (FindChildItemPSSnapIn01:String) [Add-PSSnapin], PSSnapInExcepti
      + FullyQualifiedErrorId : AddPSSnapInRead,Microsoft.PowerShell.Commands.AddPSSnapinCommand

  13. I have a problem with the regexp for -Name. If I use the command

    (Get-ChildItem -Recurse | Where-Object {$_.Name -match "^[a-z]+\.ps1$" }).FullName

    I get the results as expected (in my case 2 files). But if I use the Find-ChildItem variant in the same dir, I get zero results. What is wrong with my syntax?

    Find-ChildItem -Type f -Name "^[a-z]+\.ps1$"

  14. Why don't you include installation script into .zip, so spare us from reading these long and boring instructions!

  15. I despise winblowz, but tools like this make the experience of having to use it at work somewhat bearable. Thanks!

  16. Hi Jagadish,
    This command works fine. I want to know if i can find files older than 1 hour or a certain time using this command. Could you please provide me the syntax if its possible.


  17. Hello!! I'am glad to read the whole content of this blog and am very excited.Thank you.
    gclub casino
    goldenslot casino

  18. Online casinos you will not be disappointed.
    GclubOnline casino site It is an online game that has rules of entertainment as the desire of the player to add more and more. Come to create a novelty. To the society of fun people. Open up the great life of online gambling. By playing gambling through the internet. Which is currently the online casino. Become an interesting game. And more and more popular with us because we can forward the fun on mobile. Of online games in the form of online gambling. The format of the game developed from playing casino. Online gambling games for players to choose from a wide range of services such as casino games, online casinos, online casinos, roulette and other games. In addition, we also have live broadcast directly from the casino. That allows players to feel like playing gambling games in the casino. So we can feel the dampness of online gaming as well as our website has a high security and high security. All players are confident that. You are going to gamble online. Safely at our siteRoyal1688


  19. Gambling games that you can play every day.
    รอยัล1688Online Investment Games Website Provider Investors can come to help the player to find the gambling to play well in the top. Bet on the online player you want to play every day. Full day on selected bets. Earn a lot of money. Make more profits. Want to enjoy and experience gambling in other ways. You can always bet on the gambling always with the opportunity to invest in the game to invest online games with us here.

    It is also a simple bet to invest. Anyone interested can invest in it. Time at our site. To play like a good play in the top. Want to gamble on gambling? It is always possible to play at any time, to gamble as you choose to make more profits. Ready to bet on everything you want to bet on gambling in any way. It is always possible to bet on online casino sites and online sports investing sites of our website. Guarantee that the player will not be disappointed in this course. viva3388

  20. Website to entertainment
    Gclub SlotOur online casino site. Is a website that offers online gambling services to gamblers and those who are interested in joining us. The most comprehensive and modern in the present. And no matter what you do at any time, you can access unlimited online casinos. In addition, our online casino site has chosen a variety of formats. Developed from a real casino abroad. Come to our website developed for you, you do not have to spend time to travel far. And games with a variety of games. Variety of choices You can play anywhere. You can choose to play as you like. By all you can define yourself. Which you decide on in each game itself. To win each game and earn prizes. And if you plan to play games well. Not only will it keep you entertained in your spare time. You will also receive a large reward. And more special If your play has a problem, we have a 24 hour support staff that you do not need to worry about. And our staff will help you comfortably. You can enjoy our online casino and relax with the style of online gambling. Every time you click on us visit our website. Holiday Palace

  21. Getting to play the best online gambling games.
    GclubMeans the center of the famous online casino games. One of the best online gambling sites for Poipet websites. This casino is considered to be a reputable and well-known online casino game provider. It is also popular today. And importantly, playing online gambling games with gambling clubs. This online casino players can play whenever the player wants. Because web service provider Open 24 hours a day, so playing a game of online casino games of the player can set the time to play on your own. For playing online casino games is another new way to play online casino games, all forms can be played easily by playing gambling games. Every online via the Internet whenever a player has an internet connection, the player can access all online gambling games. Called the fun and excitement challenge, the player's online casino games can be played twice as easily. The player can join in the fun and start playing online casino games along with. Gamblers around the world have a web presence. Royal1688