diff --git a/teams/teams-ps/MicrosoftTeams/Get-CsUserCallingSettings.md b/teams/teams-ps/MicrosoftTeams/Get-CsUserCallingSettings.md index 8d12f172a7..a6ec6c426c 100644 --- a/teams/teams-ps/MicrosoftTeams/Get-CsUserCallingSettings.md +++ b/teams/teams-ps/MicrosoftTeams/Get-CsUserCallingSettings.md @@ -53,6 +53,7 @@ UnansweredTargetType : Voicemail UnansweredDelay : 00:00:20 Delegates : Delegators : +MaximumConcurrentCalls : CallGroupOrder : InOrder CallGroupTargets : {} GroupMembershipDetails : @@ -77,6 +78,7 @@ UnansweredTargetType : Voicemail UnansweredDelay : 00:00:20 Delegates : Delegators : +MaximumConcurrentCalls : CallGroupOrder : InOrder CallGroupTargets : {} GroupMembershipDetails : @@ -103,6 +105,7 @@ UnansweredTargetType : Voicemail UnansweredDelay : 00:00:20 Delegates : Delegators : +MaximumConcurrentCalls : CallGroupOrder : InOrder CallGroupTargets : {sip:user5@contoso.com} GroupMembershipDetails : CallGroupOwnerId:sip:user6@contoso.com @@ -139,6 +142,7 @@ UnansweredTargetType : Voicemail UnansweredDelay : 00:00:20 Delegates : Id:sip:user8@contoso.com Delegators : +MaximumConcurrentCalls : CallGroupOrder : InOrder CallGroupTargets : {} GroupMembershipDetails : @@ -175,6 +179,7 @@ UnansweredTargetType : Voicemail UnansweredDelay : 00:00:20 Delegates : Delegators : Id:sip:user10@contoso.com +MaximumConcurrentCalls : CallGroupOrder : InOrder CallGroupTargets : {} GroupMembershipDetails : @@ -211,6 +216,7 @@ UnansweredTargetType : UnansweredDelay : 00:00:20 Delegates : Delegators : +MaximumConcurrentCalls : CallGroupOrder : Simultaneous CallGroupTargets : {} GroupMembershipDetails : @@ -220,6 +226,31 @@ GroupNotificationOverride : This example shows the default settings for a user that has never changed the call forward settings via Microsoft Teams. Note that for users with settings as shown here, unanswered calls will by default be forwarded to voicemail after 30 seconds. +### Example 7 - View Resource Account Calling Settings +```powershell +Get-CsUserCallingSettings -Identity resource_account1@contoso.com +``` +```output +SipUri : +IsForwardingEnabled : True +ForwardingType : Simultaneous +ForwardingTarget : +ForwardingTargetType : MyDelegates +IsUnansweredEnabled : True +UnansweredTarget : +UnansweredTargetType : ResourceAccount +UnansweredDelay : 00:00:20 +Delegates : CAPphone1@contoso.com +Delegators : +MaximumConcurrentCalls : 10 +CallGroupOrder : Simultaneous +CallGroupTargets : {} +GroupMembershipDetails : +GroupNotificationOverride : +``` + +This example displays the calling settings of a Resource Account configured with CAP phone delegates. The output shows that calls are simultaneously forwarded to the assigned delegates, with a maximum of 10 concurrent calls allowed. Any additional incoming calls are handled according to the Resource Account's unanswered call settings. + ## PARAMETERS ### -Break diff --git a/teams/teams-ps/MicrosoftTeams/Set-CsUserCallingSettings.md b/teams/teams-ps/MicrosoftTeams/Set-CsUserCallingSettings.md index 14d1b274c9..549bfffa41 100644 --- a/teams/teams-ps/MicrosoftTeams/Set-CsUserCallingSettings.md +++ b/teams/teams-ps/MicrosoftTeams/Set-CsUserCallingSettings.md @@ -13,11 +13,16 @@ title: Set-CsUserCallingSettings # Set-CsUserCallingSettings ## SYNOPSIS -This cmdlet will set the call forwarding, simultaneous ringing and call group settings for the specified user. +Configures calling settings for a specified user or Resource Account, including call forwarding, simultaneous ringing, call groups, delegation, and other call-handling options. + +For user accounts, this cmdlet enables configuration of delegates and user-specific call-handling behaviour. + +For Resource Accounts, these settings are primarily used in Shared Line Appearance (SLA) scenarios, where the Resource Account is associated with the primary phone number and delegated participants (such as CAP devices or associated users) are configured to handle incoming calls on behalf of the Resource Account. ## SYNTAX ### Identity (Default) + ``` Set-CsUserCallingSettings -Identity [-HttpPipelinePrepend ] [] ``` @@ -66,8 +71,12 @@ Set-CsUserCallingSettings -Identity [-HttpPipelinePrepend [] ``` + + ## DESCRIPTION -This cmdlet sets the call forwarding, simultaneous ringing and call group settings for the specified user. +This cmdlet sets the call forwarding, simultaneous ringing and call group settings for the specified user or Resource Account. + +When configuring a Target Type for forwarding or unanswered call settings, calls can be redirected to ..... either a user or a Resource Account. When a Resource Account is specified as the target advanced routing scenarios such as forwarding calls to Auto Attendants (AA), Call Queues (CQ), or other Resource Accounts associated Agents. When specifying settings you need to specify all settings with a settings grouping, for instance, you can't just change a forwarding target. Instead, you need to start by getting the current settings, making the necessary changes, and then setting/writing all settings within the settings group. @@ -168,6 +177,15 @@ Set-CsUserCallingSettings -Identity user7@contoso.com -IsUnansweredEnabled $fals This example shows turning off unanswered call forwarding for a user. The Microsoft Teams client will show this as _If unanswered Do nothing_. +### Example 12 - Configure Maximum Concurrent Calls for a Resource Account +```powershell +Set-CsUserCallingSettings -Identity resource_account1@contoso.com --MaximumConcurrentCalls 10 +``` + +This example configures the maximum number of concurrent calls that can be forwarded to the CAP phone delegates of a Resource Account. The Identity parameter specifies the Resource Account. + +The MaximumConcurrentCalls setting determines how many simultaneous calls can be handled by the Resource Account's CAP phone delegates. A value of 10 is the recommended default and provides the best calling experience for most CAP phone deployments. When this limit is reached, additional incoming calls are handled according to the Resource Account's unanswered call settings. + ## PARAMETERS ### -CallGroupOrder @@ -358,6 +376,23 @@ Default value: None Accept pipeline input: False Accept wildcard characters: False ``` +### -MaximumConcurrentCalls + +Applies only to Resource Accounts configured for a Call Delegation scenario with CAP phones. In this configuration, the Identity parameter must specify a Resource Account, while the delegates are CAP phone users. + +The MaximumConcurrentCalls setting defines the maximum number of simultaneous calls that can be handled by the Resource Account's CAP phone delegates. When the configured limit is reached, any additional incoming calls are automatically routed according to the Resource Account's unanswered call settings. + +```yaml +Type: System.Int32 +Parameter Sets: MaximumConcurrentCalls +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` ### -UnansweredDelay