Public/generated/Get-KriticalUtcmTeamsUserCallingSettings.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-KriticalUtcmTeamsUserCallingSettings { <# .SYNOPSIS Kritical.UTCM shim for M365DSC resource TeamsUserCallingSettings. .DESCRIPTION Search-replace safe: callers that today invoke Get-M365DSCTeamsUserCallingSettings -Credential $cred -TenantId $tid can rename to Get-KriticalUtcmTeamsUserCallingSettings -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: 19 #> [CmdletBinding()] param( # The Identity of the user to set call forwarding, simultaneous ringing and call group settings for. Can be specified using the ObjectId or the SIP address. [Parameter(Mandatory)] [string]$Identity, # The group notification override that will be set on the specified user. The supported values are Ring, Mute and Banner. [ValidateSet('Ring','Mute','Banner')] [string]$GroupNotificationOverride, # The order in which to call members of the Call Group. The supported values are Simultaneous and InOrder. [string]$CallGroupOrder, # This parameter controls whether forwarding for unasnwered calls is enabled or not. [bool]$IsUnansweredEnabled, # The time the call will ring the user before it is forwarded to the unanswered target. The supported format is hh:mm:ss and the delay range needs to be between 10 and 60 seconds in 10 seconds increments, i.e. 00:00:10, 00:00:20, 00:00:30, 00:00:40, 00:00:50 and 00:01:00. The default value is 20 seconds. [string]$UnansweredDelay, # The unanswered target. Supported type of values are ObjectId, SIP address and phone number. For phone numbers we support the following types of formats: E.164 (+12065551234 or +1206555000;ext=1234) or non-E.164 like 1234. [string]$UnansweredTarget, # The unanswered target type. Supported values are Voicemail, SingleTarget, MyDelegates and Group. [ValidateSet('Group','MyDelegates','SingleTarget','Voicemail')] [string]$UnansweredTargetType, # This parameter controls whether forwarding is enabled or not. [bool]$IsForwardingEnabled, # The type of forwarding to set. Supported values are Immediate and Simultaneous [ValidateSet('Immediate','Simultaneous')] [string]$ForwardingType, # The forwarding target type. Supported values are Voicemail, SingleTarget, MyDelegates and Group. Voicemail is only supported for Immediate forwarding. [ValidateSet('Group','MyDelegates','SingleTarget','Voicemail')] [string]$ForwardingTargetType, # The forwarding target. Supported types of values are ObjectId's, SIP addresses and phone numbers. For phone numbers we support the following types of formats: E.164 (+12065551234 or +1206555000;ext=1234) or non-E.164 like 1234. [string]$ForwardingTarget, # Present ensures the policy exists, absent ensures it is removed. [ValidateSet('Present','Absent')] [string]$Ensure, # Credentials of the Teams Global Admin. [string]$Credential, # Id of the Azure Active Directory application to authenticate with. [string]$ApplicationId, # Name of the Azure Active Directory tenant used for authentication. Format contoso.onmicrosoft.com [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 'TeamsUserCallingSettings' -Workload 'Teams' -Verb 'Get' -CallerParams $PSBoundParameters } |