Edit

Share via

Get-CsUserCallingSettings

  • Reference
Module:
MicrosoftTeamsPowerShell
Applies to:
Microsoft Teams

This cmdlet will show the call forwarding, simultaneous ringing, call group and delegation settings for a user.

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 user1@contoso.com

SipUri                    : sip:user1@contoso.com
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 user1@contoso.com has immediate call forwarding set (IsForwardingEnabled and ForwardingType) to route all incoming calls to voicemail (ForwardingTargetType).

Example 2

Get-CsUserCallingSettings -Identity user2@contoso.com

SipUri                    : sip:user2@contoso.com
IsForwardingEnabled       : True
ForwardingType            : Simultaneous
ForwardingTarget          : sip:user3@contoso.com
ForwardingTargetType      : SingleTarget
IsUnansweredEnabled       : True
UnansweredTarget          :
UnansweredTargetType      : Voicemail
UnansweredDelay           : 00:00:20
Delegates                 :
Delegators                :
CallGroupOrder            : InOrder
CallGroupTargets          : {}
GroupMembershipDetails    :
GroupNotificationOverride :

This example shows that user2@contoso.com has simultaneous ringing set (IsForwardingEnabled and ForwardingType) to user3@contoso.com (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 user4@contoso.com

SipUri                    : sip:user4@contoso.com
IsForwardingEnabled       : True
ForwardingType            : Simultaneous
ForwardingTarget          :
ForwardingTargetType      : Group
IsUnansweredEnabled       : True
UnansweredTarget          :
UnansweredTargetType      : Voicemail
UnansweredDelay           : 00:00:20
Delegates                 :
Delegators                :
CallGroupOrder            : InOrder
CallGroupTargets          : {sip:user5@contoso.com}
GroupMembershipDetails    : CallGroupOwnerId:sip:user6@contoso.com
GroupNotificationOverride : Mute

(Get-CsUserCallingSettings -Identity user4@contoso.com).GroupMembershipDetails

CallGroupOwnerId            NotificationSetting
----------------            -------------------
sip:user6@contoso.com           Ring

This example shows that user4@contoso.com has simultaneous ringing set to his/her call group (ForwardingTargetType) and that the call group contains user5@contoso.com (CallGroupTargets). The call group is defined to ring members in the order listed in the call group (CallGroupOrder).

You can also see that user4@contoso.com is a member of user6@contoso.com's call group (GroupMembershipDetails), that user6@contoso.com defined the call group with Ring notification for user4@contoso.com (NotificationSetting) and that user4@contoso.com has decided to turn off call notification for call group calls (GroupNotificationOverride).

Example 4

Get-CsUserCallingSettings -Identity user7@contoso.com

SipUri                    : sip:opr7@contoso.com
IsForwardingEnabled       : True
ForwardingType            : Simultaneous
ForwardingTarget          :
ForwardingTargetType      : MyDelegates
IsUnansweredEnabled       : True
UnansweredTarget          :
UnansweredTargetType      : Voicemail
UnansweredDelay           : 00:00:20
Delegates                 : Id:sip:user8@contoso.com
Delegators                : 
CallGroupOrder            : InOrder
CallGroupTargets          : {}
GroupMembershipDetails    :
GroupNotificationOverride : Ring

(Get-CsUserCallingSettings -Identity user7@contoso.com).Delegates

Id             : sip:user8@contoso.com
MakeCalls      : True
ManageSettings : True
ReceiveCalls   : True

This example shows that user7@contoso.com has simultaneous ringing set to his/her delegates (ForwardingTargetType). User8@contoso.com is the only delegate (Delegates) and that user has all the permissions you can have as a delegate (Delegates).

Example 5

Get-CsUserCallingSettings -Identity user9@contoso.com

SipUri                    : sip:user9@contoso.com
IsForwardingEnabled       : False
ForwardingType            : Immediate
ForwardingTarget          :
ForwardingTargetType      : Voicemail
IsUnansweredEnabled       : True
UnansweredTarget          :
UnansweredTargetType      : Voicemail
UnansweredDelay           : 00:00:20
Delegates                 :
Delegators                : Id:sip:user10@contoso.com
CallGroupOrder            : InOrder
CallGroupTargets          : {}
GroupMembershipDetails    :
GroupNotificationOverride : Ring

(Get-CsUserCallingSettings -Identity user9@contoso.com).Delegators

Id             : sip:user10@contoso.com
MakeCalls      : True
ManageSettings : True
ReceiveCalls   : True

This example shows that user9@contoso.com is a delegate of user10@contoso.com (Delegators) and that user10@contoso.com has given user9@contoso.com all the permissions you can have as a delegate (Delegators).

Example 6

Get-CsUserCallingSettings -Identity user11@contoso.com

SipUri                    : sip:user11@contoso.com
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

The Identity of the user to show call forwarding, simultaneous ringing, call group and delegation settings for. Can be specified using the ObjectId or the SIP address.

Type:System.String
Position:named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

Inputs

None

Outputs

System.Object

Notes

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