Get-CsUserCallingSettings

Syntax

Get-CsUserCallingSettings
   -Identity <String>
   [<CommonParameters>]

Description

This cmdlet shows the call forwarding, simultaneous ringing, call group and delegation settings for a user. It will also show any call groups the user is a member of and if someone else has added the user as a delegate.

Examples

Example 1

Get-CsUserCallingSettings -Identity [email protected]

SipUri                    : sip:[email protected]
IsForwardingEnabled       : True
ForwardingType            : Immediate
ForwardingTarget          :
ForwardingTargetType      : Voicemail
IsUnansweredEnabled       : False
UnansweredTarget          :
UnansweredTargetType      : Voicemail
UnansweredDelay           : 00:00:20
Delegates                 :
Delegators                :
CallGroupOrder            : InOrder
CallGroupTargets          : {}
GroupMembershipDetails    :
GroupNotificationOverride :

This example shows that [email protected] has immediate call forwarding set (IsForwardingEnabled and ForwardingType) to route all incoming calls to voicemail (ForwardingTargetType).

Example 2

Get-CsUserCallingSettings -Identity [email protected]

SipUri                    : sip:[email protected]
IsForwardingEnabled       : True
ForwardingType            : Simultaneous
ForwardingTarget          : sip:[email protected]
ForwardingTargetType      : SingleTarget
IsUnansweredEnabled       : True
UnansweredTarget          :
UnansweredTargetType      : Voicemail
UnansweredDelay           : 00:00:20
Delegates                 :
Delegators                :
CallGroupOrder            : InOrder
CallGroupTargets          : {}
GroupMembershipDetails    :
GroupNotificationOverride :

This example shows that [email protected] has simultaneous ringing set (IsForwardingEnabled and ForwardingType) to [email protected] (ForwardingTarget and ForwardingTargetType) and if the call has not been answered (IsUnansweredEnabled) within 20 seconds (UnansweredDelay) the call is routed to voicemail (UnansweredTargetType).

Example 3

Get-CsUserCallingSettings -Identity [email protected]

SipUri                    : sip:[email protected]
IsForwardingEnabled       : True
ForwardingType            : Simultaneous
ForwardingTarget          :
ForwardingTargetType      : Group
IsUnansweredEnabled       : True
UnansweredTarget          :
UnansweredTargetType      : Voicemail
UnansweredDelay           : 00:00:20
Delegates                 :
Delegators                :
CallGroupOrder            : InOrder
CallGroupTargets          : {sip:[email protected]}
GroupMembershipDetails    : CallGroupOwnerId:sip:[email protected]
GroupNotificationOverride : Mute

(Get-CsUserCallingSettings -Identity [email protected]).GroupMembershipDetails

CallGroupOwnerId            NotificationSetting
----------------            -------------------
sip:[email protected]           Ring

This example shows that [email protected] has simultaneous ringing set to his/her call group (ForwardingTargetType) and that the call group contains [email protected] (CallGroupTargets). The call group is defined to ring members in the order listed in the call group (CallGroupOrder).

You can also see that [email protected] is a member of [email protected]'s call group (GroupMembershipDetails), that [email protected] defined the call group with Ring notification for [email protected] (NotificationSetting) and that [email protected] has decided to turn off call notification for call group calls (GroupNotificationOverride).

Example 4

Get-CsUserCallingSettings -Identity [email protected]

SipUri                    : sip:[email protected]
IsForwardingEnabled       : True
ForwardingType            : Simultaneous
ForwardingTarget          :
ForwardingTargetType      : MyDelegates
IsUnansweredEnabled       : True
UnansweredTarget          :
UnansweredTargetType      : Voicemail
UnansweredDelay           : 00:00:20
Delegates                 : Id:sip:[email protected]
Delegators                :
CallGroupOrder            : InOrder
CallGroupTargets          : {}
GroupMembershipDetails    :
GroupNotificationOverride : Ring

(Get-CsUserCallingSettings -Identity [email protected]).Delegates

Id             : sip:[email protected]
MakeCalls      : True
ManageSettings : True
ReceiveCalls   : True

This example shows that [email protected] has simultaneous ringing set to his/her delegates (ForwardingTargetType). [email protected] is the only delegate (Delegates) and that user has all the permissions you can have as a delegate (Delegates).

Example 5

Get-CsUserCallingSettings -Identity [email protected]

SipUri                    : sip:[email protected]
IsForwardingEnabled       : False
ForwardingType            : Immediate
ForwardingTarget          :
ForwardingTargetType      : Voicemail
IsUnansweredEnabled       : True
UnansweredTarget          :
UnansweredTargetType      : Voicemail
UnansweredDelay           : 00:00:20
Delegates                 :
Delegators                : Id:sip:[email protected]
CallGroupOrder            : InOrder
CallGroupTargets          : {}
GroupMembershipDetails    :
GroupNotificationOverride : Ring

(Get-CsUserCallingSettings -Identity [email protected]).Delegators

Id             : sip:[email protected]
MakeCalls      : True
ManageSettings : True
ReceiveCalls   : True

This example shows that [email protected] is a delegate of [email protected] (Delegators) and that [email protected] has given [email protected] all the permissions you can have as a delegate (Delegators).

Example 6

Get-CsUserCallingSettings -Identity [email protected]

SipUri                    : sip:[email protected]
IsForwardingEnabled       :
ForwardingType            :
ForwardingTarget          :
ForwardingTargetType      :
IsUnansweredEnabled       :
UnansweredTarget          :
UnansweredTargetType      :
UnansweredDelay           : 00:00:20
Delegates                 :
Delegators                :
CallGroupOrder            : Simultaneous
CallGroupTargets          : {}
GroupMembershipDetails    :
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.

Parameters

-Identity

Inputs

None

Outputs

System.Object

Notes

The cmdlet is available in Teams PowerShell module 4.0.0 or later.

Related Links

• Set-CsUserCallingSettings
• New-CsUserCallingDelegate
• Set-CsUserCallingDelegate
• Remove-CsUserCallingDelegate