Get-FileOwner.ps1


Description

@GitHub Copilot - Welcome @BanterBoy, I’m your Copilot and I’m here to help you get things done faster. I can identify issues, explain and even improve code.

You can ask generic questions, but what I’m really good at is helping you with your code. For example:

Generate unit tests for my code Explain the selected code Propose a fix for the bugs in my code If you want to learn more about my capabilities and limitations, check out the Copilot documentation.

I’m powered by AI, so surprises and mistakes are possible. Make sure to verify any generated code or suggestions, and share feedback so that we can learn and improve.

@BanterBoy: - Explain what the script does and why it is useful.

@GitHub Copilot -


Script

<#
.SYNOPSIS
	Produce a simple HTML report of all files in a folder, who the owner is
	and when the file was last written.
.DESCRIPTION
	Produce a simple HTML report of all files in a folder, who the owner is
	and when the file was last written.  You can specify if you want all sub-
	folders included in the report and also narrow the report to specific
	extensions if you want.

	Make sure to edit the $ReportPath in the parameters section to match your
	environment (if desired).

	**CAUTION** The bigger the directory structure the longer this script will
	run.  Be patient!

	Script inspired by a question on Spiceworks:
	http://community.spiceworks.com/topic/283850-how-to-find-out-who-is-putting-what-on-shared-drives
.PARAMETER Path
	Specify the path where you want the report to run
.PARAMETER FileExtension
	Specify the extension that you want to narrow your search to.  Do not include
	any wildcards.  IE  jpg, xls, etc.
.PARAMETER SubFolders
	Specify whether you want the report to include all sub-folders of the
	path.  Must use $true or $false.
.PARAMETER ReportPath
	Specify where you want the html report to be stored.  Report will be called
	Get-FileOwner.html
.OUTPUTS
	Get-FileOwner.html in the specified report path ($ReportPath parameter).
.EXAMPLE
	.\Get-FileOwner.ps1 -path s:\accounting -ReportPath s:\it
	Will create a report of all files in s:\accounting, and all sub-folders and
	place the HTML report in the s:\it folder.
.EXAMPLE
	.\Get-FileOwner.ps1 -path s:\accounting -SubFolders $false
	Will create a report of all files in the s:\accounting folder only and place
	the report in the default location, c:\utils.
.EXAMPLE
	.\Get-FileOwner.ps1 -path s:\accounting -FileExtension xls
	Will create a report of all xls files in s:\accounting and all sub-folders.
	HTML report will be saved in the default location, c:\utils
.NOTES
	Author:       Martin Pugh
	Twitter:      @thesurlyadm1n
	Spiceworks:   Martin9700
	Blog:         www.thesurlyadmin.com

	Changelog:
	   1.0        Initial release
.LINK
	http://community.spiceworks.com/scripts/show/1722-get-fileowner
.LINK
	http://community.spiceworks.com/topic/283850-how-to-find-out-who-is-putting-what-on-shared-drives
#>
Param (
	[Parameter(Mandatory=$true)]
	[string]$Path,
	[string]$FileExtension = "*",
	[bool]$SubFolders = $true,
	[string]$ReportPath = "c:\utils"
)

If ($SubFolders)
{	$SubFoldersText = "(including sub-folders)"
}
Else
{	$SubFoldersText = "(does <i>not</i> include sub-folders)"
}

$Header = @"
<style type='text/css'>
body { background-color:#DCDCDC;
}
table { border:1px solid gray;
  font:normal 12px verdana, arial, helvetica, sans-serif;
  border-collapse: collapse;
  padding-left:30px;
  padding-right:30px;
}
th { color:black;
  text-align:left;
  border: 1px solid black;
  font:normal 16px verdana, arial, helvetica, sans-serif;
  font-weight:bold;
  background-color: #6495ED;
  padding-left:6px;
  padding-right:6px;
}
td { border: 1px solid black;
  padding-left:6px;
  padding-right:6px;
}
</style>
<center>
<h1>Files by Owner</h1>
<h2>Path: $Path\*.$FileExtension $SubFoldersText</h2>
<br>
"@

If ($FileExtension -eq "*")
{	$GCIProperties = @{
		Path = $Path
		Recurse = $SubFolders
	}
}
Else
{	$GCIProperties = @{
		Path = "$Path\*"
		Include = "*.$FileExtension"
		Recurse = $SubFolders
	}
}

$Report = @()
Foreach ($File in (Get-ChildItem @GCIProperties | Where-Object { $_.PSisContainer -eq $false }))
{
	$Report += New-Object PSObject -Property @{
		Path = $File.FullName
		Size = "{0:N2} MB" -f ( $File.Length / 1mb )
		'Created on' = $File.CreationTime
		'Last Write Time' = $File.LastWriteTime
		Owner = (Get-Acl $File.FullName).Owner
	}
}

$Report |
Select-Object Path,Size,'Created on','Last Write Time',Owner |
Sort-Object Path |
ConvertTo-Html -Head $Header |
Out-File $ReportPath\Get-FileOwner.html

#This line will open your web browser and display the report.  Rem it out with a # if you don't want it to
Invoke-Item $ReportPath\Get-FileOwner.html

Back to Top


Download

Please feel free to copy parts of the script or if you would like to download the entire script, simple click the download button. You can download the complete repository in a zip file by clicking the Download link in the menu bar on the left hand side of the page.


Report Issues

You can report an issue or contribute to this site on GitHub. Simply click the button below and add any relevant notes. I will attempt to respond to all issues as soon as possible.

Issue


Back to Top