Public/generated/Get-KriticalUtcmSCRetentionComplianceRule.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-KriticalUtcmSCRetentionComplianceRule {
<#
.SYNOPSIS
    Kritical.UTCM shim for M365DSC resource SCRetentionComplianceRule.

.DESCRIPTION

    Search-replace safe: callers that today invoke
        Get-M365DSCSCRetentionComplianceRule -Credential $cred -TenantId $tid
    can rename to
        Get-KriticalUtcmSCRetentionComplianceRule -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: Purview
    Param count: 16
#>

[CmdletBinding()]
param(
        # The Name parameter specifies the unique name of the retention rule.
[Parameter(Mandatory)] [string]$Name,
        # The Policy parameter specifies the policy to contain the rule.
[Parameter(Mandatory)] [string]$Policy,
        # Specify if this rule should exist or not.
[ValidateSet('Present','Absent')] [string]$Ensure,
        # The Comment parameter specifies an optional comment.
[string]$Comment,
        # The ExpirationDateOption parameter specifies whether the expiration date is calculated from the content creation date or last modification date. Valid values are: CreationAgeInDays and ModificationAgeInDays.
[ValidateSet('CreationAgeInDays','ModificationAgeInDays')] [string]$ExpirationDateOption,
        # The ContentMatchQuery parameter specifies a content search filter.
[string]$ContentMatchQuery,
        # The RetentionComplianceAction parameter specifies the retention action for the rule. Valid values are: Delete, Keep and KeepAndDelete.
[ValidateSet('Delete','Keep','KeepAndDelete')] [string]$RetentionComplianceAction,
        # The RetentionDuration parameter specifies the hold duration for the retention rule. Valid values are: An integer - The hold duration in days, Unlimited - The content is held indefinitely.
[string]$RetentionDuration,
        # The RetentionDurationDisplayHint parameter specifies the units that are used to display the retention duration in the Security and Compliance Center. Valid values are: Days, Months or Years.
[ValidateSet('Days','Months','Years')] [string]$RetentionDurationDisplayHint,
        # Credentials of the Exchange Global Admin
[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,
        # 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 'SCRetentionComplianceRule' -Workload 'Purview' -Verb 'Get' -CallerParams $PSBoundParameters
}