Functions/Strings/Find-StringExtraDetails.ps1

function Find-StringExtraDetails
{

<#
    .SYNOPSIS
    Find a string in one or multiple files
                 
    .DESCRIPTION
    Find a string in one or multiple files. The search is performed recursively from the start folder.
                                 
    .EXAMPLE
    Find-StringInFile -Path "C:\Scripts\FolderWithFiles" -Search "Test01"
       
    Filename Path LineNumber IsBinary Matches
    -------- ---- ---------- -------- -------
    File_01.txt E:\Temp\Files\File_01.txt 1 False {Test01}
    File_02.txt E:\Temp\Files\File_02.txt 1 False {TEST01}
    File_03.txt E:\Temp\Files\File_03.txt 1 False {TeST01}
    .EXAMPLE
    Find-StringInFile -Path "C:\Scripts\FolderWithFiles" -Search "TEST01" -CaseSensitive
    Filename Path LineNumber IsBinary Matches
    -------- ---- ---------- -------- -------
    File_02.txt E:\Temp\Files\File_02.txt 1 False {TEST01}
    

#>


    [CmdletBinding()]
    param(
    [Parameter(
            Position=0,
            Mandatory=$true, ValueFromPipeline=$true,
            HelpMessage='String to find')]
        $Search,

        [Parameter(
            Position=1,
            HelpMessage='Folder where the files are stored (search is recursive)')]
        [ValidateScript({
            if(Test-Path -Path $_)
            {
                return $true
            }
            else 
            {
                throw 'Enter a valid path!'    
            }
        })]
        [String]$Path = (Get-Location),
        
        [Parameter(
            Position=2,
            HelpMessage='String must be case sensitive (Default=false)')]
        [switch]$CaseSensitive
    )

    Begin{
        
    }

    Process{
        # Files with string to find
        $Strings = Get-ChildItem -Path $Path -Recurse | Select-String -Pattern ([regex]::Escape($Search)) -CaseSensitive:$CaseSensitive | Group-Object -Property Path 
        
        # Go through each file
        foreach($String in $Strings)
        {        
            # Go through each group
            foreach($Group in $String.Group)
            {    
                [pscustomobject] @{
                    Filename = $Group.Filename
                    Path = $Group.Path
                    LineNumber = $Group.LineNumber
                    Matches = $Group.Matches.Captures
                    Line = $Group.Line
                }
            }   
        }
    }

    End{
        
    }
}