Get-FileAndFolderPermissions

Get-FileAndFolderPermissions -SourcePath C:\

Get-FileAndFolderPermissions -SourcePath C:\ -Recurse true

<#
	.SYNOPSIS
		Get-FileAndFolderPermissions can be used to extract file or folder permissions for a given path.

	.DESCRIPTION
		Get-FileAndFolderPermissions can be used to extract file or folder permissions for a given path. You can choose between 'File' or 'Folder' permissions and you can choose whether or not to recurse through the folder structure of the given path.

	.PARAMETER SourcePath
		Enter the path for the folder that you would like to extract the permissions.

	.PARAMETER FileFolder
		Specify whether you would like to get 'File' or 'Folder' permissions. The Default is Folder permissions.

	.PARAMETER Recurse
			Specify whether you would like to recurse the folder structure for permissions. The Default is disabled.

	.PARAMETER Extension
		Specifies the extension. The Default is '.*'

		You can tab complete through the suggested list of extensions.

		'.AIFF', '.AIF', '.AU', '.AVI', '.BAT', '.BMP', '.CHM', '.CLASS', '.CONFIG', '.CSS', '.CSV', '.CVS', '.DBF', '.DIF', '.DOC', '.DOCX', '.DLL', '.DOTX', '.EPS', '.EXE', '.FM3', '.GIF', '.HQX', '.HTM', '.HTML', '.ICO', '.INF', '.INI', '.JAVA', '.JPG', '.JPEG', '.JSON', '.LOG', '.MD', '.MP4', '.MAC', '.MAP', '.MDB', '.MID', '.MIDI', '.MKV', '.MOV', '.QT', '.MTB', '.MTW', '.PDB', '.PDF', '.P65', '.PNG', '.PPT', '.PPTX', '.PSD', '.PSP', '.PS1', '.PSD1', '.PSM1', '.QXD', '.RA', '.RTF', '.SIT', '.SVG', '.TAR', '.TIF', '.T65', '.TXT', '.VBS', '.VSDX', '.WAV', '.WK3', '.WKS', '.WPD', '.WP5', '.XLS', '.XLSX', '.XML', '.YML', '.ZIP', '.*'

		'.AIFF or .AIF'	Audio Interchange File Format
		'.AU'	Basic Audio
		'.AVI'	Multimedia Audio/Video
		'.BAT'	PC batch file
		'.BMP'	Windows BitMap
		'.CLASS' or .JAVA	Java files
		'.CSV'	Comma separated, variable length file (Open in Excel)
		'.CVS'	Canvas
		'.DBF'	dbase II, III, IV data
		'.DIF'	Data Interchange format
		'.DOC or .DOCX'	Microsoft Word for Windows/Word97
		'.EPS'	Encapsulated PostScript
		'.EXE'	PC Application
		'.FM3'	Filemaker Pro databases (the numbers following represent the version #)
		'.GIF'	Graphics Interchange Format
		'.HQX'	Macintosh BinHex
		'.HTM or .HTML'	Web page source text
		'.JPG or JPEG'	JPEG graphic
		'.MAC'	MacPaint
		'.MAP'	Web page imagemap
		'.MDB'	MS Access database
		'.MID or .MIDI'	MIDI sound
		'.MKV'    Matroska video
		'.MOV or .QT'	QuickTime Audio/Video
		'.MTB or .MTW'	MiniTab
		'.PDF'	Acrobat -Portable document format
		'.P65'
		'.T65'	PageMaker (the numbers following represent the version #) P=publication, T=template
		'.PNG'	Portable Network Graphics
		'.PPT or .PPTX'	PowerPoint
		'.PSD'	Adobe PhotoShop
		'.PSP'	PaintShop Pro
		'.QXD'	QuarkXPress
		'.RA'	RealAudio
		'.RTF'	Rich Text Format
		'.SIT'	Stuffit Compressed Archive
		'.TAR'	UNIX TAR Compressed Archive
		'.TIF'	TIFF graphic
		'.TXT'	ASCII text (Mac text does not contain line feeds--use DOS Washer Utility to fix)
		'.WAV'	Windows sound
		'.WK3'	Lotus 1-2-3 (the numbers following represent the version #)
		'.WKS'	MS Works
		'WPD or .WP5'	WordPerfect (the numbers following represent the version #)
		'.XLS or .XLSX'	Excel spreadsheet
		'.ZIP'	PC Zip Compressed Archive

	.INPUTS
		You can pipe objects to these perameters.
		[string] SourcePath
		[string] FileFolder
		[string] Recurse
		[string] Extension

	.OUTPUTS
		object

	.EXAMPLE
		Get-FileAndFolderPermissions

	.EXAMPLE
		Get-FileAndFolderPermissions -SourcePath C:\

	.EXAMPLE
		Get-FileAndFolderPermissions -SourcePath C:\ -Recurse true

	.NOTES
		Author:	Luke Leigh
		Website:	https://scripts.lukeleigh.com/
		LinkedIn:	https://www.linkedin.com/in/lukeleigh/
		GitHub:	https://github.com/BanterBoy/scripts-blog
		GitHubGist:	https://gist.github.com/BanterBoy

	.LINK
		Get-Childitem
		Get-Acl
		New-Object
		Where-Object
		ForEach-Object
		Write-Warning
		Write-Output
#>


Function Get-FileAndFolderPermissions {

	[CmdletBinding(DefaultParameterSetName = 'Default',
		PositionalBinding = $true,
		SupportsShouldProcess = $true)]
	[Alias('GFPR')]
	[OutputType([object], ParameterSetName = 'Default')]
	param
	(
		[Parameter(ParameterSetName = 'Default',
			Mandatory = $false,
			ValueFromPipeline = $true,
			ValueFromPipelineByPropertyName = $true,
			Position = 1,
			HelpMessage = 'Enter the directory string that you want to search. Default is the current directory.')]

		[Alias('sp')]
		[String]$SourcePath = ".",

		[Parameter(ParameterSetName = 'Default',
			Mandatory = $false,
			ValueFromPipelineByPropertyName = $true,
			Position = 2,
			HelpMessage = 'Specify whether you want to search for files or folders. Default is folders.')]

		[ValidateSet('File', 'Folder')]
		[Alias('ff')]
		[string]$FileFolder = 'Folder',

		[Parameter(ParameterSetName = 'Default',
			Mandatory = $false,
			ValueFromPipelineByPropertyName = $true,
			Position = 3,
			HelpMessage = 'Include this switch to recurse through all subfolders.')]

		[Alias('rec')]
		[switch]$Recurse,

		[Parameter(
			Mandatory = $false,
			Position = 4,
			ParameterSetName = "Default",
			ValueFromPipelineByPropertyName,
			HelpMessage = "Select the file extension you are looking for. Defaults to '.*' files.")]
		[ValidateSet('.AIFF', '.AIF', '.AU', '.AVI', '.BAT', '.BMP', '.CHM', '.CLASS', '.CONFIG', '.CSS', '.CSV', '.CVS', '.DBF', '.DIF', '.DOC', '.DOCX', '.DLL', '.DOTX', '.EPS', '.EXE', '.FM3', '.GIF', '.HQX', '.HTM', '.HTML', '.ICO', '.INF', '.INI', '.JAVA', '.JPG', '.JPEG', '.JSON', '.LOG', '.MD', '.MP4', '.MAC', '.MAP', '.MDB', '.MID', '.MIDI', '.MKV', '.MOV', '.QT', '.MTB', '.MTW', '.PDB', '.PDF', '.P65', '.PNG', '.PPT', '.PPTX', '.PSD', '.PSP', '.PS1', '.PSD1', '.PSM1', '.QXD', '.RA', '.RTF', '.SIT', '.SVG', '.TAR', '.TIF', '.T65', '.TXT', '.VBS', '.VSDX', '.WAV', '.WK3', '.WKS', '.WPD', '.WP5', '.XLS', '.XLSX', '.XML', '.YML', '.ZIP', '.*')]
		[string]$Extension = '.*'
	)

	Begin {
	}

	Process {
		if ($pscmdlet.ShouldProcess("$SourcePath", "Extracting permissions")) {

			# Determine if we need to use recursion
			if ($FileFolder -eq 'File') {
				$fileType = '*' + $Extension
				if ($Recurse) {
					$Search = Get-ChildItem -Path $SourcePath -Recurse -ErrorAction SilentlyContinue | Where-Object { 
                        (!$_.psiscontainer) -and ($_.FullName -like $fileType)
					}
				}
				else {
					$Search = Get-ChildItem -Path $SourcePath -ErrorAction SilentlyContinue | Where-Object { 
                        (!$_.psiscontainer) -and ($_.FullName -like $fileType)
					}
				}
			}
			elseif ($FileFolder -eq 'Folder') {
				if ($Recurse) {
					$Search = Get-ChildItem -Path $SourcePath -Recurse -ErrorAction SilentlyContinue | Where-Object { 
						$_.psiscontainer -eq $true
					}
				}
				else {
					$Search = Get-ChildItem -Path $SourcePath -ErrorAction SilentlyContinue | Where-Object { 
						$_.psiscontainer -eq $true
					}
				}
			}

			foreach ($item in $Search) {
				$ACLs = Get-Acl $item.FullName | ForEach-Object { $_.Access }
				try {
					foreach ($ACL in $ACLs) {
						$OutInfo = @{
							Fullname          = $item.FullName
							IdentityReference = $ACL.IdentityReference
							AccessControlType = $ACL.AccessControlType
							IsInherited       = $ACL.IsInherited
							InheritanceFlags  = $ACL.InheritanceFlags
							PropagationFlags  = $ACL.PropagationFlags
						}
						$obj = New-Object -TypeName PSObject -Property $OutInfo
						Write-Output $obj
					}
				}
				catch {
					Write-Warning "$_"
				}
			}
		}
	}

	End {
		Write-Verbose "Search for permissions completed."
	}
}