Search-FileAccess PowerShell Script

Search-FileAccess.ps1

function Search-FileAccess {
  param (
    [Parameter(Mandatory=$true)]
    [string]$IdentityReferenceRegex,
    [Parameter(Mandatory=$true)]
    [string]$Path,
    [Boolean]$Recurse=$true,
    [switch]$Visualization
  )

  $matchingFolders = Get-ChildItem -Recurse:$Recurse $Path | Where-Object {
    $isDirectory = $_.Attributes -contains 'Directory'

    $accessList = $_ | Get-Acl | Select-Object -ExpandProperty Access
    $matchingAccessList = $accessList | Where-Object {
      $_.IdentityReference.Value -match $IdentityReferenceRegex
    }
    $accessListPersonMatched = $matchingAccessList.Count -gt 0
    $matchingAccessList = $matchingAccessList | Where-Object IsInherited -eq $false
    $fileMatched = $matchingAccessList.Count -gt 0

    if ($Visualization) {
      $symbol = if ($isDirectory) { '#' } else { ':' }
      $color = if ($fileMatched) { 'Red' } else {
        if ($accessListPersonMatched) { 'DarkGreen' } else { 'Green' }
      }
      Write-Host $symbol -ForegroundColor $color -NoNewline
    }

    return $fileMatched
  }

  if ($Visualization) {
    Write-Host "`n`n`n"
  }

  if ($VerbosePreference) {
    $statusColor = if ($matchingFolders.Count -gt 0) { 'Red' } else { 'Cyan'}
    Write-Host "`n`nMatching folders: $($matchingFolders.Count)" -ForegroundColor $statusColor
    $matchingFolders | Select-Object -ExpandProperty FullName | Sort-Object | Out-Host
  }

  return $matchingFolders
}