Private/Compare-PSObject.ps1
|
<#
.COPYRIGHT Copyright (c) ECIT Solutions AS. All rights reserved. Licensed under the MIT license. See https://github.com/ecitsolutions/Autotask/blob/master/LICENSE.md for license information. #> Function Compare-PSObject { <# .SYNOPSIS This function compares two collections of PSObjects and returns $true if they are identical by value. .DESCRIPTION This function compares two collections of PSObjects and returns $true if they are identical by value. .INPUTS [PSObject[]] .OUTPUTS [bool] .EXAMPLE Compare-PSObject -ReferenceObject $Collection1 -DifferenceObject $Collection2 Returns true if both collections contains the same objects by value .NOTES NAME: Compare-PSObject #> [CmdLetBinding()] Param ( [Parameter( Mandatory = $true, Position = 0 )] [PSObject[]] $ReferenceObject, [Parameter( Mandatory = $true, ValueFromPipeLine = $true, Position = 1 )] [PSObject[]] $DifferenceObject ) begin { # Enable modern -Debug behavior if ($PSCmdlet.MyInvocation.BoundParameters['Debug'].IsPresent) { $DebugPreference = 'Continue' } Write-Debug ('{0}: Begin of function' -F $MyInvocation.MyCommand.Name) # A bright hope for an identical future $identical = $true } process { Write-Verbose ('{0}: Comparing collection of {1} objects to different collection of {2} objects' -F $MyInvocation.MyCommand.Name, $ReferenceObject.Count, $DifferenceObject.count) # Both objects must have the same number of items if ($ReferenceObject.Count -eq $DifferenceObject.Count) { # Compare collections both ways, any object in one should exist in the other foreach ($object in $ReferenceObject) { # Get the index of the current object $index = $ReferenceObject.IndexOf($object) # Is it a system.<type>? if ($object.GetType().Fullname -match 'System\.\w+$' -and $object -ne $DifferenceObject[$index]) { $identical = $false break } else { # Get the names of the properties $propertyList = $object | Get-Member -MemberType Property, NoteProperty | ForEach-Object Name # Compare all properties with the object with same index in other collection $difference = Compare-Object -ReferenceObject $object -DifferenceObject $DifferenceObject[$index] -Property $propertyList if ($difference) { $identical = $false break } # Do we have a picklist? If so, compare picklist values, too if ($object.PicklistValues.Count -gt 0) { # Compare picklistvalues $difference = Compare-Object -ReferenceObject $object.PicklistValues -DifferenceObject $DifferenceObject[$index].PicklistValues -Property value, label, sortorder, isactive if ($difference) { $identical = $false break } } } } } else { $identical = $false } } end { Write-Debug ('{0}: End of function' -F $MyInvocation.MyCommand.Name) Return $identical } } |