functions/Add-PpacEnvironmentGroupAcpPolicyAssignment.ps1
|
<#
.SYNOPSIS Assign an ACP policy to an environment group. .DESCRIPTION Creates a governance policy assignment for an environment group and returns the resulting ACP policy. .PARAMETER EnvironmentGroupId The unique identifier of the environment group. .PARAMETER PolicyId Policy GUID or display name. Multiple name matches are rejected. .EXAMPLE PS C:\> Add-PpacEnvironmentGroupAcpPolicyAssignment -EnvironmentGroupId "00000000-0000-0000-0000-000000000000" -PolicyId "11111111-1111-1111-1111-111111111111" Assigns the ACP policy to the group. It uses -EnvironmentGroupId to select the group. It uses -PolicyId to select the policy. .NOTES Author: d365bap.tools contributors #> function Add-PpacEnvironmentGroupAcpPolicyAssignment { [CmdletBinding(SupportsShouldProcess = $true, ConfirmImpact = 'High')] [OutputType('D365Bap.Tools.PpacEnvironmentGroupAcpPolicy')] param ( [Parameter(Mandatory = $true)] [ValidateNotNullOrEmpty()] [string] $EnvironmentGroupId, [Parameter(Mandatory = $true)] [ValidateNotNullOrEmpty()] [string] $PolicyId ) process { $groupLabel = $EnvironmentGroupId try { $objGroup = Get-PpacEnvironmentGroup -EnvironmentGroup $EnvironmentGroupId | Select-Object -First 1 if ((-Not ($null -eq $objGroup)) ` -and (-not [string]::IsNullOrWhiteSpace($objGroup.DisplayName))) { $groupLabel = $objGroup.DisplayName } } catch { $groupLabel = $EnvironmentGroupId } $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 } $shouldAffected = $policyName $shouldLabel = "Assign ACP policy to group '$groupLabel'" if (-not $PSCmdlet.ShouldProcess($shouldAffected, $shouldLabel)) { return } $colAssigned = @(Add-PpacEnvironmentGroupRuleBasedPolicyAssignment -EnvironmentGroupId $EnvironmentGroupId ` -PolicyId $colPolicy[0].PolicyId ` -Confirm:$false) if ($colAssigned.Count -eq 0) { return } Get-PpacEnvironmentGroupAcpPolicy -EnvironmentGroupId $EnvironmentGroupId ` -PolicyId $colPolicy[0].PolicyId } } |