Microsoft Teams – Manage User Call Forward and Unanswered Call Settings Using PowerShell – Set-CsUserCallingSettings

The latest release of the Microsoft Teams cmdlets module (MicrosoftTeams 3.0.1-preview) added functionalities to the Set-CsUserCallingSettings command, finally allowing Teams administrators to manage users’ forwarding and unanswered calls settings from PowerShell.

Note: to install the Public Preview of the Microsoft Teams Module use “Install-Module -Name MicrosoftTeams -AllowPrerelease“

The Set-CsUserCallingSettings uses the logic you can see in the diagram below

Here are some practical usage examples:

Remove Call Forward for the Teams’ user:

Set-CsUserCallingSettings -Identity [email protected] -IsForwardingEnabled $false

Immediately forward all the calls to a phone number:

Set-CsUserCallingSettings -Identity [email protected] -IsForwardingEnabled $true -ForwardingType immediate -ForwardingTargetType singletarget -ForwardingTarget “Phone Number”

Immediately forward all the calls to a Teams user:

Set-CsUserCallingSettings -Identity [email protected] -IsForwardingEnabled $true -ForwardingType immediate -ForwardingTargetType singletarget -ForwardingTarget “destination_[email protected]“

Simultaneously ring user’s delegates:

Set-CsUserCallingSettings -Identity [email protected] -IsForwardingEnabled $true -ForwardingType Simultaneous -ForwardingTargetType MyDelegates

If the call is unanswered (after the call forward process), the -IsUnansweredEnabled must be enabled with the logic in the diagram below

For example, with the following command, you can add a redirection to a phone number if the call is unanswered for 30 seconds

Set-CsUserCallingSettings -Identity [email protected] -IsUnansweredEnabled $true -UnansweredDelay 00:00:30 -UnansweredTargetType singleTarget -UnansweredTarget “telephonenumber”