Commands › Microsoft Teams

Set-CsUserCallingSettings

Microsoft Teams MicrosoftTeams Set-*

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 behavior. For phone-centric scenarios, this cmdlet also supports resource account identities configured for Teams Phone Agents, Call Queues, Auto Attendants, and standalone resource accounts. For these resource accounts, the cmdlet configures immediate forwarding, unanswered call settings, and the maximum number of concurre

Quick start script

# Set-CsUserCallingSettings — quick start (serv365.ai)
# 1. Connect (app-only shown; interactive: omit the certificate parameters)
Connect-MicrosoftTeams -CertificateThumbprint $thumb -ApplicationId $appId -TenantId $tenantId

# 2. Capture the current state first — you cannot roll back what you never recorded
$before = Get-CsUserCallingSettings
$before | Format-List

# 3. Make the change
Set-CsUserCallingSettings -BusyOnBusyOption <String> -CallGroupOrder <String> -CallGroupTargets <Array>

# 4. Verify and diff
$after = Get-CsUserCallingSettings
Compare-Object ($before | Out-String) ($after | Out-String)

Syntax — 10 parameter sets

Identity (Default)

Set-CsUserCallingSettings -Identity <String> [-HttpPipelinePrepend <SendAsyncStep[]>] [<CommonParameters>]

BusyOnBusy

Set-CsUserCallingSettings -Identity <String> [-HttpPipelinePrepend <SendAsyncStep[]>]
 -BusyOnBusyOption <String> [<CommonParameters>]

CallGroupNotification

Set-CsUserCallingSettings -Identity <String> [-HttpPipelinePrepend <SendAsyncStep[]>]
 -GroupNotificationOverride <String> [<CommonParameters>]

CallGroupMembership

Set-CsUserCallingSettings -Identity <String> [-HttpPipelinePrepend <SendAsyncStep[]>]
 -GroupMembershipDetails <ICallGroupMembershipDetails[]> [<CommonParameters>]

6 more parameter sets — see the parameter table below.

Parameters (16)

ParameterTypeRequiredWhat it controls
-BusyOnBusyOption String yes The busy on busy setting for the specified user. Busy on busy controls what happens to a new incoming call when the specified user is already in a call or in a conference. The supported values are:
-CallGroupOrder String yes The order in which to call members of the Call Group. The supported values are Simultaneous and InOrder.
-CallGroupTargets Array yes The members of the Call Group. You need to always specify the full set of members as the parameter value. What you set here will overwrite the current call group membership.
-ForwardingTarget String Specifies the target for forwarded calls. The target can be a user, resource account, or phone number.
-ForwardingTargetType String yes The forwarding target type.
-ForwardingType String yes The type of forwarding to set. Supported values are Immediate and Simultaneous
-GroupMembershipDetails ICallGroupMembershipDetails[] yes The group membership details for the specified user. It is an array of ICallGroupMembershipDetails, which is an object containing the identity of an owner of a call group and the notification setting for the...
-GroupNotificationOverride String yes The group notification override that will be set on the specified user. The supported values are Ring, Mute and Banner.
-HttpPipelinePrepend SendAsyncStep[] {{ Fill HttpPipelinePrepend Description }}
-Identity String yes The identity of the user or resource account to set call forwarding, simultaneous ringing, call group, delegation, and other applicable calling settings for. A user or resource account can be specified using the...
-IsForwardingEnabled Boolean yes This parameter controls whether forwarding is enabled or not.
-IsUnansweredEnabled Boolean yes This parameter controls whether forwarding for unanswered calls is enabled or not.
-MaximumConcurrentCalls Int32 Specifies the maximum number of concurrent calls that can be handled by delegates assigned to a resource account. Supported values are from 0 through 50.
-UnansweredDelay String yes 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 5 and 60 seconds in 5 seconds increments between 5 and 15...
-UnansweredTarget String Specifies the target for unanswered calls. Supported values include a user, resource account, or phone number. A user or resource account can be specified using its ObjectId or SIP address, as applicable.
-UnansweredTargetType String The unanswered call target type.

Reference facts derived from Microsoft documentation, © Microsoft, licensed CC BY 4.0; restructured with original guidance by serv365.ai.