Functions/Compare-ObjectSetComplement.ps1
|
function Compare-ObjectSetComplement { <# .SYNOPSIS Compares 2 arrays of strings and returns The SET COMPLEMENT of the arrays .DESCRIPTION Compares 2 arrays of strings and returns The SET COMPLEMENT of the arrays. Optionally case sensitive. .PARAMETER ReferenceObject The array that is the baseline. Aliased to 'RO', 'Left' .PARAMETER DifferenceObject The array that is being compared to the baseline set. Aliased to 'DO', 'Right' .PARAMETER CaseSensitive Switch indicating that a case sensitive comparison should be made. Aliased to 'CS' .EXAMPLE Compare-ObjectSetComplement -ReferenceObject a,b,c -DifferenceObject a,c -CaseSensitive b .EXAMPLE Compare-ObjectSetComplement -ReferenceObject a,b,c -DifferenceObject a,b,C -CaseSensitive c .EXAMPLE Compare-ObjectSetComplement -ReferenceObject a,b,c -DifferenceObject a,b,c,D $null .EXAMPLE Compare-ObjectSetComplement -ReferenceObject a,b,c -DifferenceObject a,b,C $null .NOTES Inspired by: https://sqljana.wordpress.com/2015/09/23/perform-set-operations-union-intersection-minus-complement-using-powershell/ http://www.cs.odu.edu/~toida/nerzic/content/set/set_operations.html http://www.dummies.com/how-to/content/find-the-union-intersection-relative-complement-an.html #> [CmdletBinding()] [outputtype('psobject')] param ( [Alias('RO', 'Left')] [string[]] $ReferenceObject, [Alias('DO', 'Right')] [string[]] $DifferenceObject, [Alias('CS')] [switch] $CaseSensitive ) begin { Write-Verbose -Message "Starting [$($MyInvocation.Mycommand)]" } process { if ($CaseSensitive) { Compare-Object -ReferenceObject $ReferenceObject -DifferenceObject $DifferenceObject -Passthru -IncludeEqual -CaseSensitive | Where-Object { -not ($DifferenceObject -ccontains $_) } } else { Compare-Object -ReferenceObject $ReferenceObject -DifferenceObject $DifferenceObject -Passthru -IncludeEqual | Where-Object { -not ($DifferenceObject -contains $_) } } } end { Write-Verbose -Message "Ending [$($MyInvocation.Mycommand)]" } } |