Get-CsUserCallingSettings
This cmdlet will show the call forwarding, simultaneous ringing, call group and delegation settings for a user.
Syntax
Get (Default)
Get-CsUserCallingSettings
-Identity <String>
[-Break]
[-HttpPipelineAppend <SendAsyncStep[]>]
[-HttpPipelinePrepend <SendAsyncStep[]>]
[-Proxy <Uri>]
[-ProxyCredential <PSCredential>]
[-ProxyUseDefaultCredentials]
[<CommonParameters>]
GetViaIdentity
Get-CsUserCallingSettings
-InputObject <IConfigApiBasedCmdletsIdentity>
[-Break]
[-HttpPipelineAppend <SendAsyncStep[]>]
[-HttpPipelinePrepend <SendAsyncStep[]>]
[-Proxy <Uri>]
[-ProxyCredential <PSCredential>]
[-ProxyUseDefaultCredentials]
[<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
-Break
{{ Fill Break Description }}
Parameter properties
| Type: | System.Management.Automation.SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-HttpPipelineAppend
{{ Fill HttpPipelineAppend Description }}
Parameter properties
| Type: | Microsoft.Teams.ConfigAPI.Cmdlets.Generated.Runtime.SendAsyncStep[] |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-HttpPipelinePrepend
{{ Fill HttpPipelinePrepend Description }}
Parameter properties
| Type: | Microsoft.Teams.ConfigAPI.Cmdlets.Generated.Runtime.SendAsyncStep[] |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-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.
Parameter properties
| Type: | System.String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
Get
| Position: | Named |
| Mandatory: | True |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-InputObject
{{ Fill InputObject Description }}
Parameter properties
| Type: | Microsoft.Teams.ConfigAPI.Cmdlets.Generated.Models.IConfigApiBasedCmdletsIdentity |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
GetViaIdentity
| Position: | Named |
| Mandatory: | True |
| Value from pipeline: | True |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-Proxy
{{ Fill Proxy Description }}
Parameter properties
| Type: | System.Uri |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-ProxyCredential
{{ Fill ProxyCredential Description }}
Parameter properties
| Type: | System.Management.Automation.PSCredential |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-ProxyUseDefaultCredentials
{{ Fill ProxyUseDefaultCredentials Description }}
Parameter properties
| Type: | System.Management.Automation.SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.
Inputs
None
Outputs
System.Object
Notes
The cmdlet is available in Teams PowerShell module 4.0.0 or later.