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

.DESCRIPTION

    Search-replace safe: callers that today invoke
        Get-M365DSCTeamsShiftsPolicy -Credential $cred -TenantId $tid
    can rename to
        Get-KriticalUtcmTeamsShiftsPolicy -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: Teams
    Param count: 15
#>

[CmdletBinding()]
param(
        # Specifies the policy instance name
[Parameter(Mandatory)] [string]$Identity,
        # Determines the grace period time in minutes between when the first shift starts or last shift ends and when access is blocked
[long]$AccessGracePeriodMinutes,
        # Determines the Teams access type granted to the user. Today, only unrestricted access to Teams app is supported.
[ValidateSet('UnrestrictedAccess_TeamsApp')] [string]$AccessType,
        # Determines whether a user can manage a Shifts schedule as a team member.
[bool]$EnableScheduleOwnerPermissions,
        # Determines the frequency of warning dialog displayed when user opens Teams.
[ValidateSet('Always','ShowOnceOnChange','Never')] [string]$ShiftNoticeFrequency,
        # Specifies a custom message. Must set ShiftNoticeMessageType to 'CustomMessage' to enforce this
[string]$ShiftNoticeMessageCustom,
        # Specifies the warning message is shown in the blocking dialog when a user access Teams off shift hours. Select one of 7 Microsoft provided messages, a default message or a custom message.
[ValidateSet('DefaultMessage','Message1','Message2','Message3','Message4','Message5','Message6','Message7','CustomMessage')] [string]$ShiftNoticeMessageType,
        # Present ensures the instance exists, absent ensures it is removed.
[ValidateSet('Present','Absent')] [string]$Ensure,
        # Credentials of the workload's 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 'TeamsShiftsPolicy' -Workload 'Teams' -Verb 'Get' -CallerParams $PSBoundParameters
}