How to Configure Teams Calling Policies and Outbound PSTN Rules Using PowerShell CsTeamsCallingPolicy

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.

Get the best tech tips delivered straight to your inbox.

Join thousands of readers mastering Apple, Google, Microsoft, and Linux.