scripts/helpers/Build-FpacResourcePlan.ps1

function Build-FpacResourcePlan {
    param (
        [Parameter(Mandatory)]
        [string] $ResourceType,

        [Parameter(Mandatory)]
        [System.Collections.IDictionary] $Desired,

        [Parameter(Mandatory)]
        [System.Collections.IDictionary] $Deployed,

        [Parameter()]
        [System.Collections.IDictionary] $DesiredComparison,

        [Parameter()]
        [System.Collections.IDictionary] $DeployedComparison,

        [Parameter()]
        [string[]] $ReplacementFields = @(),

        [Parameter()]
        [string] $PacOwnerId,

        [Parameter()]
        [ValidateSet('OwnedOnly', 'Full')]
        [string] $DesiredStateStrategy = 'OwnedOnly'
    )

    Write-FpacModernSection -Title "Processing $ResourceType"
    if ($null -eq $DesiredComparison) {
        $DesiredComparison = $Desired
    }
    if ($null -eq $DeployedComparison) {
        $DeployedComparison = $Deployed
    }
    $plan = New-FpacPlanBucket
    foreach ($name in @($Desired.Keys) | Sort-Object) {
        $desiredArtifact = $Desired[$name]
        if (-not $Deployed.Contains($name)) {
            $plan.new[$name] = $desiredArtifact
            Write-FpacModernStatus -Message "New: $name" -Status success
            continue
        }

        $deployedArtifact = $Deployed[$name]
        $desiredComparisonArtifact = $DesiredComparison[$name]
        $deployedComparisonArtifact = $DeployedComparison[$name]
        $changedFields = @(Get-FpacChangedFields -Desired $desiredComparisonArtifact.properties -Deployed $deployedComparisonArtifact.properties)
        $deployedMetadata = Get-FabricPropertyValue -InputObject $deployedArtifact -Name 'metadata'
        $deployedOwner = [string] (Get-FabricPropertyValue -InputObject $deployedMetadata -Name 'pacOwnerId')
        if (-not [string]::IsNullOrWhiteSpace($PacOwnerId) -and
            -not [string]::Equals($deployedOwner, $PacOwnerId, [System.StringComparison]::OrdinalIgnoreCase)) {
            if (-not [string]::IsNullOrWhiteSpace($deployedOwner)) {
                throw "$ResourceType resource '$name' is owned by '$deployedOwner', not configured PAC owner '$PacOwnerId'."
            }
            $plan.adopt[$name] = [ordered]@{
                name        = $name
                changes     = @('ownership') + $changedFields
                differences = @(
                    [ordered]@{
                        path     = 'metadata.pacOwnerId'
                        change   = 'Adopt'
                        oldValue = if ([string]::IsNullOrWhiteSpace($deployedOwner)) { $null } else { $deployedOwner }
                        newValue = $PacOwnerId
                    }
                ) + @(Get-FpacObjectDifferences -Desired $desiredComparisonArtifact.properties `
                    -Deployed $deployedComparisonArtifact.properties -Path 'properties')
                desired     = $desiredArtifact
                deployed    = $deployedArtifact
            }
            Write-FpacModernStatus -Message "Adopt: $name" -Status warning
            continue
        }
        if ($changedFields.Count -eq 0) {
            $plan.numberUnchanged++
            Write-FpacModernStatus -Message "Unchanged: $name" -Status info
            continue
        }

        $requiresReplacement = @($changedFields | Where-Object { $_ -in $ReplacementFields }).Count -gt 0
        if ($requiresReplacement -and $changedFields -contains 'scope') {
            $desiredScopeType = [string] $desiredComparisonArtifact.properties.scope.type
            $deployedScopeType = [string] $deployedComparisonArtifact.properties.scope.type
            if ([string]::Equals($desiredScopeType, $deployedScopeType, [System.StringComparison]::OrdinalIgnoreCase)) {
                $requiresReplacement = @($changedFields | Where-Object {
                    $_ -in $ReplacementFields -and $_ -ne 'scope'
                }).Count -gt 0
            }
        }
        $action = if ($requiresReplacement) { 'replace' } else { 'update' }
        $status = if ($requiresReplacement) { 'warning' } else { 'update' }
        $plan[$action][$name] = [ordered]@{
            name       = $name
            changes    = $changedFields
            differences = @(Get-FpacObjectDifferences -Desired $desiredComparisonArtifact.properties `
                -Deployed $deployedComparisonArtifact.properties -Path 'properties')
            desired    = $desiredArtifact
            deployed   = $deployedArtifact
        }
        Write-FpacModernStatus -Message "$($action.Substring(0, 1).ToUpperInvariant())$($action.Substring(1)) ($($changedFields -join ', ')): $name" -Status $status
    }

    foreach ($name in @($Deployed.Keys) | Sort-Object) {
        if (-not $Desired.Contains($name)) {
            if ($DesiredStateStrategy -eq 'OwnedOnly' -and -not [string]::IsNullOrWhiteSpace($PacOwnerId)) {
                $deployedMetadata = Get-FabricPropertyValue -InputObject $Deployed[$name] -Name 'metadata'
                $deployedOwner = [string] (Get-FabricPropertyValue -InputObject $deployedMetadata -Name 'pacOwnerId')
                if (-not [string]::Equals($deployedOwner, $PacOwnerId, [System.StringComparison]::OrdinalIgnoreCase)) {
                    Write-FpacModernStatus -Message "Unmanaged: $name" -Status info
                    continue
                }
            }
            $plan.delete[$name] = $Deployed[$name]
            Write-FpacModernStatus -Message "Delete: $name" -Status error
        }
    }

    $plan.numberOfChanges = $plan.new.Count + $plan.update.Count + $plan.replace.Count + $plan.adopt.Count + $plan.delete.Count
    return $plan
}