This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| # Compare-Directory.ps1 | |
| # Compare files in one or more directories and return file difference results | |
| # Victor Vogelpoel <victor@victorvogelpoel.nl> | |
| # Sept 2013 | |
| # | |
| # Disclaimer | |
| # This script is provided AS IS without warranty of any kind. I disclaim all implied warranties including, without limitation, | |
| # any implied warranties of merchantability or of fitness for a particular purpose. The entire risk arising out of the use or | |
| # performance of the sample scripts and documentation remains with you. In no event shall I be liable for any damages whatsoever | |
| # (including, without limitation, damages for loss of business profits, business interruption, loss of business information, | |
| # or other pecuniary loss) arising out of the use of or inability to use the script or documentation. | |
| # Compare-Directory -ReferenceDirectory "C:\Compare-Directory\FrontEnd1-Site" -DifferenceDirectory "C:\Compare-Directory\FrontEnd2-Site" | |
| function Compare-Directory | |
| { | |
| [CmdletBinding()] | |
| param | |
| ( | |
| [Parameter(Mandatory=$true, position=0, ValueFromPipelineByPropertyName=$true, HelpMessage="The reference directory to compare one or more difference directories to.")] | |
| [System.IO.DirectoryInfo]$ReferenceDirectory, | |
| [Parameter(Mandatory=$true, position=1, ValueFromPipeline=$true, ValueFromPipelineByPropertyName=$true, HelpMessage="One or more directories to compare to the reference directory.")] | |
| [System.IO.DirectoryInfo[]]$DifferenceDirectory, | |
| [Parameter(Mandatory=$false, ValueFromPipelineByPropertyName=$true, HelpMessage="Recurse the directories")] | |
| [switch]$Recurse, | |
| [Parameter(Mandatory=$false, ValueFromPipelineByPropertyName=$true, HelpMessage="Files to exclude from the comparison")] | |
| [String[]]$ExcludeFile, | |
| [Parameter(Mandatory=$false, ValueFromPipelineByPropertyName=$true, HelpMessage="Directories to exclude from the comparison")] | |
| [String[]]$ExcludeDirectory, | |
| [Parameter(Mandatory=$false, ValueFromPipelineByPropertyName=$true, HelpMessage="Displays only the characteristics of compared objects that are equal.")] | |
| [switch]$ExcludeDifferent, | |
| [Parameter(Mandatory=$false, ValueFromPipelineByPropertyName=$true, HelpMessage="Displays characteristics of files that are equal. By default, only characteristics that differ between the reference and difference files are displayed.")] | |
| [switch]$IncludeEqual, | |
| [Parameter(Mandatory=$false, ValueFromPipelineByPropertyName=$true, HelpMessage="Passes the objects that differed to the pipeline.")] | |
| [switch]$PassThru | |
| ) | |
| begin | |
| { | |
| function Get-MD5 | |
| { | |
| [CmdletBinding(SupportsShouldProcess=$false)] | |
| param | |
| ( | |
| [Parameter(Mandatory=$true, ValueFromPipeline=$true, ValueFromPipelineByPropertyName=$true, HelpMessage="file(s) to create hash for")] | |
| [Alias("File", "Path", "PSPath", "String")] | |
| [ValidateNotNull()] | |
| $InputObject | |
| ) | |
| begin | |
| { | |
| $cryptoServiceProvider = [System.Security.Cryptography.MD5CryptoServiceProvider] | |
| $hashAlgorithm = new-object $cryptoServiceProvider | |
| } | |
| process | |
| { | |
| $hashByteArray = "" | |
| $item = Get-Item $InputObject -ErrorAction SilentlyContinue | |
| if ($item -is [System.IO.DirectoryInfo]) { throw "Cannot create hash for directory" } | |
| if ($item) { $InputObject = $item } | |
| if ($InputObject -is [System.IO.FileInfo]) | |
| { | |
| $stream = $null; | |
| $hashByteArray = $null | |
| try | |
| { | |
| $stream = $InputObject.OpenRead(); | |
| $hashByteArray = $hashAlgorithm.ComputeHash($stream); | |
| } | |
| finally | |
| { | |
| if ($stream -ne $null) | |
| { | |
| $stream.Close(); | |
| } | |
| } | |
| } | |
| else | |
| { | |
| $utf8 = new-object -TypeName "System.Text.UTF8Encoding" | |
| $hashByteArray = $hashAlgorithm.ComputeHash($utf8.GetBytes($InputObject.ToString())); | |
| } | |
| Write-Output ([BitConverter]::ToString($hashByteArray)).Replace("-","") | |
| } | |
| } | |
| function Get-Files | |
| { | |
| [CmdletBinding(SupportsShouldProcess=$false)] | |
| param | |
| ( | |
| [string]$DirectoryPath, | |
| [String[]]$ExcludeFile, | |
| [String[]]$ExcludeDirectory, | |
| [switch]$Recurse | |
| ) | |
| $relativeBasenameIndex = $DirectoryPath.ToString().Length | |
| # Get the files from the first deploypath | |
| # and ADD the MD5 hash for the file as a property | |
| # and ADD a filepath relative to the deploypath as a property | |
| Get-ChildItem -Path $DirectoryPath -Exclude $ExcludeFile -Recurse:$Recurse | foreach { | |
| $hash = "" | |
| if (!$_.PSIsContainer) { $hash = Get-MD5 $_ } | |
| # Added two new properties to the DirectoryInfo/FileInfo objects | |
| $item = $_ | | |
| Add-Member -Name "MD5Hash" -MemberType NoteProperty -Value $hash -PassThru | | |
| Add-Member -Name "RelativeBaseName" -MemberType NoteProperty -Value ($_.FullName.Substring($relativeBasenameIndex)) -PassThru | |
| # Test for directories and files that need to be excluded because of ExcludeDirectory | |
| if ($item.PSIsContainer) { $item.RelativeBaseName += "\" } | |
| if ($ExcludeDirectory | where { $item.RelativeBaseName -like "\$_\*" }) | |
| { | |
| Write-Verbose "Ignore item `"$($item.Fullname)`"" | |
| } | |
| else | |
| { | |
| Write-Verbose "Adding `"$($item.Fullname)`" to result set" | |
| Write-Output $item | |
| } | |
| } | |
| } | |
| $referenceDirectoryFiles = Get-Files -DirectoryPath $referenceDirectory -ExcludeFile $ExcludeFile -ExcludeDirectory $ExcludeDirectory -Recurse:$Recurse | |
| } | |
| process | |
| { | |
| if ($DifferenceDirectory -and $referenceDirectoryFiles) | |
| { | |
| foreach($nextPath in $DifferenceDirectory) | |
| { | |
| $nextDifferenceFiles = Get-Files -DirectoryPath $nextpath -ExcludeFile $ExcludeFile -ExcludeDirectory $ExcludeDirectory -Recurse:$Recurse | |
| ################################################### | |
| # Compare the contents of the two file/directory arrays and return the results | |
| $results = @(Compare-Object -ReferenceObject $referenceDirectoryFiles -DifferenceObject $nextDifferenceFiles -ExcludeDifferent:$ExcludeDifferent -IncludeEqual:$IncludeEqual -PassThru:$PassThru -Property RelativeBaseName, MD5Hash) | |
| if (!$PassThru) | |
| { | |
| foreach ($result in $results) | |
| { | |
| $path = $ReferenceDirectory | |
| $pathFiles = $referenceDirectoryFiles | |
| if ($result.SideIndicator -eq "=>") | |
| { | |
| $path = $nextPath | |
| $pathFiles = $nextDifferenceFiles | |
| } | |
| # Find the original item in the files array | |
| $itemPath = (Join-Path $path $result.RelativeBaseName).ToString().TrimEnd('\') | |
| $item = $pathFiles | where { $_.fullName -eq $itemPath } | |
| $result | Add-Member -Name "Item" -MemberType NoteProperty -Value $item | |
| } | |
| } | |
| Write-Output $results | |
| } | |
| } | |
| } | |
| <# | |
| .SYNOPSIS | |
| Compares a reference directory with one or more difference directories. | |
| .DESCRIPTION | |
| Compare-Directory compares a reference directory with one ore more difference | |
| directories. Files and directories are compared both on filename and contents | |
| using a MD5hash. | |
| Internally, Compare-Object is used to compare the directories. The behavior | |
| and results of Compare-Directory is similar to Compare-Object. | |
| .PARAMETER ReferenceDirectory | |
| The reference directory to compare one or more difference directories to. | |
| .PARAMETER DifferenceDirectory | |
| One or more directories to compare to the reference directory. | |
| .PARAMETER Recurse | |
| Include subdirectories in the comparison. | |
| .PARAMETER ExcludeFile | |
| File names to exclude from the comparison. | |
| .PARAMETER ExcludeDirectory | |
| Directory names to exclude from the comparison. Directory names are | |
| relative to the Reference of Difference Directory path | |
| .PARAMETER ExcludeDifferent | |
| Displays only the characteristics of compared files that are equal. | |
| .PARAMETER IncludeEqual | |
| Displays characteristics of files that are equal. By default, only | |
| characteristics that differ between the reference and difference files | |
| are displayed. | |
| .PARAMETER PassThru | |
| Passes the objects that differed to the pipeline. By default, this | |
| cmdlet does not generate any output. | |
| .EXAMPLE | |
| Compare-Directory -reference "D:\TEMP\CompareTest\path1" -difference "D:\TEMP\CompareTest\path2" -ExcludeFile "web.config" -recurse | |
| Compares directories "D:\TEMP\CompareTest\path1" and "D:\TEMP\CompareTest\path2" recursively, excluding "web.config" | |
| Only differences are shown. Results: | |
| RelativeBaseName MD5Hash SideIndicator Item | |
| ---------------- ------- ------------- ---- | |
| bin\site.dll 87A1E6006C2655252042F16CBD7FB41B => D:\TEMP\CompareTest\path2\bin\site.dll | |
| index.html 02BB8A33E1094E547CA41B9E171A267B => D:\TEMP\CompareTest\path2\index.html | |
| index.html 20EE266D1B23BCA649FEC8385E5DA09D <= D:\TEMP\CompareTest\path1\index.html | |
| web_2.config 5E6B13B107ED7A921AEBF17F4F8FE7AF <= D:\TEMP\CompareTest\path1\web_2.config | |
| bin\site.dll 87A1E6006C2655252042F16CBD7FB41B => D:\TEMP\CompareTest\path2\bin\site.dll | |
| index.html 02BB8A33E1094E547CA41B9E171A267B => D:\TEMP\CompareTest\path2\index.html | |
| index.html 20EE266D1B23BCA649FEC8385E5DA09D <= D:\TEMP\CompareTest\path1\index.html | |
| web_2.config 5E6B13B107ED7A921AEBF17F4F8FE7AF <= D:\TEMP\CompareTest\path1\web_2.config | |
| .EXAMPLE | |
| Compare-Directory -reference "D:\TEMP\CompareTest\path1" -difference "D:\TEMP\CompareTest\path2" -ExcludeFile "web.config" -recurse -IncludeEqual | |
| Compares directories "D:\TEMP\CompareTest\path1" and "D:\TEMP\CompareTest\path2" recursively, excluding "web.config". | |
| Results include the items that are equal: | |
| RelativeBaseName MD5Hash SideIndicator Item | |
| ---------------- ------- ------------- ---- | |
| bin == D:\TEMP\CompareTest\path1\bin | |
| bin\site2.dll 98B68D681A8D40FA943D90588E94D1A9 == D:\TEMP\CompareTest\path1\bin\site2.dll | |
| bin\site3.dll 9408C4B29F82260CBBA528342CBAA80F == D:\TEMP\CompareTest\path1\bin\site3.dll | |
| bin\site4.dll 0616E1FBE12D468F611F07768D70C2EE == D:\TEMP\CompareTest\path1\bin\site4.dll | |
| ... | |
| bin\site8.dll 87A1E6006C2655252042F16CBD7FB41B => D:\TEMP\CompareTest\path2\bin\site8.dll | |
| index.html 02BB8A33E1094E547CA41B9E171A267B => D:\TEMP\CompareTest\path2\index.html | |
| index.html 20EE266D1B23BCA649FEC8385E5DA09D <= D:\TEMP\CompareTest\path1\index.html | |
| web_2.config 5E6B13B107ED7A921AEBF17F4F8FE7AF <= D:\TEMP\CompareTest\path1\web_2.config | |
| .EXAMPLE | |
| Compare-Directory -reference "D:\TEMP\CompareTest\path1" -difference "D:\TEMP\CompareTest\path2" -ExcludeFile "web.config" -recurse -ExcludeDifference | |
| Compares directories "D:\TEMP\CompareTest\path1" and "D:\TEMP\CompareTest\path2" recursively, excluding "web.config". | |
| Results only include the files that are equal; different files are excluded from the results. | |
| .EXAMPLE | |
| Compare-Directory -reference "D:\TEMP\CompareTest\path1" -difference "D:\TEMP\CompareTest\path2" -ExcludeFile "web.config" -recurse -Passthru | |
| Compares directories "D:\TEMP\CompareTest\path1" and "D:\TEMP\CompareTest\path2" recursively, excluding "web.config" and returns NO comparison | |
| results, but the different files themselves! | |
| FullName | |
| -------- | |
| D:\TEMP\CompareTest\path2\bin\site3.dll | |
| D:\TEMP\CompareTest\path2\index.html | |
| D:\TEMP\CompareTest\path1\index.html | |
| D:\TEMP\CompareTest\path1\web_2.config | |
| .LINK | |
| Compare-Object | |
| #> | |
| } | |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment