Deploying Microsoft Teams Phone across enterprise environments requires establishing granular telephony governance. Unrestricted outbound dialling can expose organizations to severe toll fraud, unauthorized international calling charges, or non-compliant routing. Furthermore, different business units—such as executive suites, contact centre agents, frontline warehouse workers, and general office staff—require distinct telephony permissions for private calling, call forwarding, simultaneous ringing, and voicemail routing.
The primary administrative mechanism controlling telephony capabilities in Microsoft Teams is the CsTeamsCallingPolicy. Using the Microsoft Teams PowerShell module, administrators can inspect existing voice policies, configure calling permissions, restrict external PSTN dialling, and assign targeted policies to users or Entra ID security groups.
Understanding Core CsTeamsCallingPolicy Parameters
The CsTeamsCallingPolicy governs calling features across Microsoft Teams desktop, mobile, and web clients. Key configurable parameters include:
- AllowPrivateCalling: Controls whether users can make 1:1 voice or video calls to internal colleagues or external federated contacts.
- AllowWebPSTNCalling: Determines whether users accessing Microsoft Teams via a web browser are permitted to place outbound PSTN calls.
- AllowCallForwardingToUser & AllowCallForwardingToPhone: Governs whether users can redirect incoming calls to other corporate colleagues or forward calls to external phone numbers (e.g. personal mobile devices).
- AllowSimultaneousRingingToContact & AllowSimultaneousRingingToPhone: Dictates whether calls can simultaneously ring secondary internal contacts or external phone lines.
- AllowVoicemail: Controls whether incoming unanswered calls can be routed to Microsoft Cloud Voicemail.
- AllowDelegation: Specifies whether users can assign delegates to make and receive calls on their behalf.
Connecting to Microsoft Teams PowerShell
Open an elevated PowerShell prompt on your workstation and authenticate to the Microsoft 365 tenant:
Connect-MicrosoftTeams
Verify that your session is active and holds Teams Administrator or Global Administrator privileges:
Get-CsTenant | Select-Object DisplayName, TenantId
Inspecting Existing Calling Policies
To view all calling policies currently provisioned across the tenant, execute:
Get-CsTeamsCallingPolicy
To inspect the default Global policy inherited by all tenant users who do not have an explicit custom policy assignment:
Get-CsTeamsCallingPolicy -Identity Global | Format-List Identity, Description, AllowPrivateCalling, AllowWebPSTNCalling, AllowCallForwardingToPhone, AllowVoicemail
The output details whether unassigned users can forward calls externally, use voicemail, or dial from web clients.
Creating a Restricted Frontline Calling Policy
For shared workstations, kiosk devices, or frontline workers where external forwarding and web-based dialling should be blocked to prevent toll abuse and maintain call centre integrity, create a restricted calling policy:
New-CsTeamsCallingPolicy -Identity "FrontlineRestrictedCallingPolicy" -Description "Restricts external forwarding and browser-based PSTN calling" -AllowPrivateCalling $true -AllowWebPSTNCalling $false -AllowCallForwardingToPhone $false -AllowSimultaneousRingingToPhone $false -AllowVoicemail "AlwaysEnabled" -AllowDelegation $false
The AllowVoicemail parameter accepts AlwaysEnabled, AlwaysDisabled, or UserOverride.
Creating an Unrestricted Executive Calling Policy
For corporate leadership and sales directors requiring complete flexibility across international travel, web browsers, delegation, and external call forwarding:
New-CsTeamsCallingPolicy -Identity "ExecutiveCallingPolicy" -Description "Full telephony capabilities including delegation and external forwarding" -AllowPrivateCalling $true -AllowWebPSTNCalling $true -AllowCallForwardingToUser $true -AllowCallForwardingToPhone $true -AllowSimultaneousRingingToPhone $true -AllowVoicemail "UserOverride" -AllowDelegation $true
Modifying Existing Calling Policies
To adjust settings on an existing policy without recreating it, use Set-CsTeamsCallingPolicy:
Set-CsTeamsCallingPolicy -Identity "FrontlineRestrictedCallingPolicy" -AllowCallForwardingToUser $true
If organizational security mandates that external call forwarding to third-party phone numbers must be prohibited globally across all unassigned staff:
Set-CsTeamsCallingPolicy -Identity Global -AllowCallForwardingToPhone $false
Assigning Calling Policies to Users and Groups
Assign the restricted or executive policy to an individual user with Grant-CsTeamsCallingPolicy:
Grant-CsTeamsCallingPolicy -Identity "[email protected]" -PolicyName "FrontlineRestrictedCallingPolicy"
To assign the policy across an entire departmental security group in Microsoft Entra ID:
Grant-CsTeamsCallingPolicy -Group "Warehouse-Operations-GroupID" -PolicyName "FrontlineRestrictedCallingPolicy" -Rank 1
To unassign an explicit policy from a user so they inherit the tenant Global baseline, specify $null:
Grant-CsTeamsCallingPolicy -Identity "[email protected]" -PolicyName $null
Verifying User Policy Assignment
Confirm the active policy applied to a target user account:
Get-CsUserPolicyAssignment -Identity "[email protected]" -PolicyType TeamsCallingPolicy
By effectively implementing CsTeamsCallingPolicy rules in PowerShell, organizations eliminate toll fraud risks and ensure seamless, role-tailored voice communication across their Microsoft Teams Phone deployment.