Public/generated/Get-KriticalUtcmAADPIMGroupSetting.ps1

# Kritical.PS.UTCM | Microsoft Graph UTCM REST API toolkit
# (c) 2026 Kritical Pty Ltd | https://kritical.net
# Kritical brand banner is rendered at module load via Write-KriticalUtcmBanner.

function Get-KriticalUtcmAADPIMGroupSetting {
<#
.SYNOPSIS
    Kritical.UTCM shim for M365DSC resource AADPIMGroupSetting.

.DESCRIPTION

    Search-replace safe: callers that today invoke
        Get-M365DSCAADPIMGroupSetting -Credential $cred -TenantId $tid
    can rename to
        Get-KriticalUtcmAADPIMGroupSetting -Credential $cred -TenantId $tid
    with ZERO other edits. Parameter shape matches the M365DSC .schema.mof
    exactly. By default -PreferM365DscBehavior is true.

    Actual Graph dispatch is delegated to Invoke-KriticalUtcmM365DscSchemaBridge.
    Bridge maps resource → Graph endpoint per per-resource wave; where mapping
    is not yet shipped, bridge returns an object with Verdict='UNMAPPED'.

.NOTES
    Workload: Entra
    Param count: 44
#>

[CmdletBinding()]
param(
        # RuleDefinition DisplayName
[Parameter(Mandatory)] [string]$DisplayName,
        # The identifier of the membership or ownership eligibility to the group that is governed by PIM. Required. The possible values are: owner, member. Supports $filter (eq).
[Parameter(Mandatory)] [ValidateSet('owner','member')] [string]$RoleDefinitionId,
        # Specifies the Group Policy Id.
[string]$Id,
        # Activation maximum duration (hours).
[string]$ActivationMaxDuration,
        # Require justification on activation (True/False)
[bool]$ActivationReqJustification,
        # Require ticket information on activation (True/False)
[bool]$ActivationReqTicket,
        # Require MFA on activation (True/False)
[bool]$ActivationReqMFA,
        # Require approval to activate (True/False)
[bool]$ApprovaltoActivate,
        # Allow permanent eligible assignment (True/False)
[bool]$PermanentEligibleAssignmentisExpirationRequired,
        # Expire eligible assignments after (Days)
[string]$ExpireEligibleAssignment,
        # Allow permanent active assignment (True/False)
[bool]$PermanentActiveAssignmentisExpirationRequired,
        # Expire active assignments after (Days)
[string]$ExpireActiveAssignment,
        # Require Azure Multi-Factor Authentication on active assignment (True/False)
[bool]$AssignmentReqMFA,
        # Require justification on active assignment (True/False)
[bool]$AssignmentReqJustification,
        # Require Azure Multi-Factor Authentication on eligible assignment (True/False)
[bool]$EligibilityAssignmentReqMFA,
        # Require justification on eligible assignment (True/False)
[bool]$EligibilityAssignmentReqJustification,
        # Send notifications when members are assigned as eligible to this group: Group assignment alert, default recipient (True/False)
[bool]$EligibleAlertNotificationDefaultRecipient,
        # Send notifications when members are assigned as eligible to this group: Group assignment alert, only critical Email (True/False)
[bool]$EligibleAlertNotificationOnlyCritical,
        # Send notifications when members are assigned as eligible to this group: Notification to the assigned user (assignee), default recipient (True/False)
[bool]$EligibleAssigneeNotificationDefaultRecipient,
        # Send notifications when members are assigned as eligible to this group: Notification to the assigned user (assignee), only critical Email (True/False)
[bool]$EligibleAssigneeNotificationOnlyCritical,
        # Send notifications when members are assigned as eligible to this group: Request to approve a group assignment renewal/extension, default recipient (True/False)
[bool]$EligibleApproveNotificationDefaultRecipient,
        # Send notifications when members are assigned as eligible to this group: Request to approve a group assignment renewal/extension, only critical Email (True/False)
[bool]$EligibleApproveNotificationOnlyCritical,
        # Send notifications when members are assigned as active to this group: Group assignment alert, default recipient (True/False)
[bool]$ActiveAlertNotificationDefaultRecipient,
        # Send notifications when members are assigned as active to this group: Group assignment alert, only critical Email (True/False)
[bool]$ActiveAlertNotificationOnlyCritical,
        # Send notifications when members are assigned as active to this group: Notification to the assigned user (assignee), default recipient (True/False)
[bool]$ActiveAssigneeNotificationDefaultRecipient,
        # Send notifications when members are assigned as active to this group: Notification to the assigned user (assignee), only critical Email (True/False)
[bool]$ActiveAssigneeNotificationOnlyCritical,
        # Send notifications when members are assigned as active to this group: Request to approve a group assignment renewal/extension, default recipient (True/False)
[bool]$ActiveApproveNotificationDefaultRecipient,
        # Send notifications when members are assigned as active to this group: Request to approve a group assignment renewal/extension, only critical Email (True/False)
[bool]$ActiveApproveNotificationOnlyCritical,
        # Send notifications when eligible members activate this group: Group assignment alert, default recipient (True/False)
[bool]$EligibleAssignmentAlertNotificationDefaultRecipient,
        # Send notifications when eligible members activate this group: Group assignment alert, only critical Email (True/False)
[bool]$EligibleAssignmentAlertNotificationOnlyCritical,
        # Send notifications when eligible members activate this group: Notification to activated user (requestor), default recipient (True/False)
[bool]$EligibleAssignmentAssigneeNotificationDefaultRecipient,
        # Send notifications when eligible members activate this group: Notification to activated user (requestor), only critical Email (True/False)
[bool]$EligibleAssignmentAssigneeNotificationOnlyCritical,
        # Authorization context is required (True/False)
[bool]$AuthenticationContextRequired,
        # Descriptive name of associated authorization context
[string]$AuthenticationContextName,
        # Authorization context id
[string]$AuthenticationContextId,
        # Specify if the Azure AD group setting should exist or not.
[ValidateSet('Present')] [string]$Ensure,
        # Credentials for the Microsoft Graph delegated permissions.
[string]$Credential,
        # Id of the Azure Active Directory application to authenticate with.
[string]$ApplicationId,
        # Id of the Azure Active Directory tenant used for authentication.
[string]$TenantId,
        # Secret of the Azure Active Directory application to authenticate with.
[string]$ApplicationSecret,
        # Thumbprint of the Azure Active Directory application's authentication certificate to use for authentication.
[string]$CertificateThumbprint,
        # Username can be made up to anything but password will be used for CertificatePassword
[string]$CertificatePassword,
        # Path to certificate used in service principal usually a PFX file.
[string]$CertificatePath,
        # Managed ID being used for authentication.
[bool]$ManagedIdentity
)
    Invoke-KriticalUtcmM365DscSchemaBridge -ResourceName 'AADPIMGroupSetting' -Workload 'Entra' -Verb 'Get' -CallerParams $PSBoundParameters
}