Commands › Microsoft Teams

Set-CsUserCallingSettings

Microsoft Teams MicrosoftTeams Set-*

This cmdlet will set the call forwarding, simultaneous ringing, call group and busy on busy settings for the specified user.

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 — 9 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>]

5 more parameter sets — see the parameter table below.

Parameters (15)

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 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...
-ForwardingTargetType String yes The forwarding target type. Supported values are Voicemail, SingleTarget, MyDelegates and Group. Voicemail is only supported for Immediate forwarding.
-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 to set call forwarding, simultaneous ringing and call group settings for. Can be specified using the ObjectId or the SIP address.
-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.
-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 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.
-UnansweredTargetType String The unanswered target type. Supported values are Voicemail, SingleTarget, MyDelegates and Group.

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