functions/Add-PpacEnvironmentAcpPolicyAssignment.ps1

<#
    .SYNOPSIS
        Assign an ACP policy to an environment.
 
    .DESCRIPTION
        Creates a governance policy assignment for an environment and returns
        the resulting ACP policy.
 
    .PARAMETER EnvironmentId
        Environment name, GUID, or Power Platform environment identifier.
 
    .PARAMETER PolicyId
        Policy GUID or display name. Multiple name matches are rejected.
 
    .EXAMPLE
        PS C:\> Add-PpacEnvironmentAcpPolicyAssignment -EnvironmentId "00000000-0000-0000-0000-000000000000" -PolicyId "11111111-1111-1111-1111-111111111111"
 
        Assigns the ACP policy to the environment.
        It uses -EnvironmentId to select the environment.
        It uses -PolicyId to select the policy.
 
    .NOTES
        Author: d365bap.tools contributors
#>

function Add-PpacEnvironmentAcpPolicyAssignment {
    [CmdletBinding(SupportsShouldProcess = $true, ConfirmImpact = 'High')]
    [OutputType('D365Bap.Tools.PpacEnvironmentAcpPolicy')]
    param (
        [Parameter(Mandatory = $true, ValueFromPipelineByPropertyName = $true)]
        [Alias('PpacEnvId')]
        [ValidateNotNullOrEmpty()]
        [string] $EnvironmentId,

        [Parameter(Mandatory = $true)]
        [ValidateNotNullOrEmpty()]
        [string] $PolicyId
    )

    process {
        $colPolicy = @(Get-PpacTenantAcpPolicy -PolicyId $PolicyId)
        if ($colPolicy.Count -eq 0) {
            Stop-PSFFunction -Message "No ACP policy matched '$PolicyId'."
            return
        }
        if ($colPolicy.Count -gt 1) {
            Stop-PSFFunction -Message "Multiple ACP policies matched '$PolicyId'. Use a policy GUID."
            return
        }

        $policyName = $colPolicy[0].Name
        if ([string]::IsNullOrWhiteSpace($policyName)) { $policyName = $colPolicy[0].PolicyId }

        $envObj = Get-Environment -EnvironmentId $EnvironmentId |
        Select-Object -First 1
        $environmentLabel = $envObj.PpacEnvName

        $shouldAffected = $policyName
        $shouldLabel = "Assign ACP policy to '$environmentLabel'"

        if (-not $PSCmdlet.ShouldProcess($shouldAffected, $shouldLabel)) { return }

        $colAssigned = @(Add-PpacEnvironmentRuleBasedPolicyAssignment -EnvironmentId $EnvironmentId `
                -PolicyId $colPolicy[0].PolicyId `
                -Confirm:$false)

        if ($colAssigned.Count -eq 0) { return }

        Get-PpacEnvironmentAcpPolicy -EnvironmentId $EnvironmentId `
            -PolicyId $colPolicy[0].PolicyId
    }
}