Commands › Microsoft Teams

Set-CsTeamsCallingPolicy

Microsoft Teams MicrosoftTeams Set-*

Use this cmdlet to update values in existing Teams Calling Policies.

Quick start script

# Set-CsTeamsCallingPolicy — quick start (serv365.ai)
# 1. Connect (app-only shown; interactive: omit the certificate parameters)
Connect-MicrosoftTeams -CertificateThumbprint $thumb -ApplicationId $appId -TenantId $tenantId

# 2. Capture the current state first — you cannot roll back what you never recorded
$before = Get-CsTeamsCallingPolicy
$before | Format-List

# 3. Make the change (dry run first)
Set-CsTeamsCallingPolicy  -WhatIf
Set-CsTeamsCallingPolicy

# 4. Verify and diff
$after = Get-CsTeamsCallingPolicy
Compare-Object ($before | Out-String) ($after | Out-String)

Syntax

Set-CsTeamsCallingPolicy [-Identity] <string>
 [-AIInterpreter <string>]
 [-AllowCallForwardingToPhone <boolean>]
 [-AllowCallForwardingToUser <boolean>]
 [-AllowCallGroups <boolean>]
 [-AllowCallRedirect <string>]
 [-AllowCloudRecordingForCalls <boolean>]
 [-AllowDelegation <boolean>]
 [-AllowPrivateCalling <boolean>]
 [-AllowSIPDevicesCalling <boolean>]
 [-AllowTranscriptionForCalling <boolean>]
 [-AllowVoicemail <string>]
 [-AllowWebPSTNCalling <boolean>]
 [-AutoAnswerEnabledType <String>]
 [-BusyOnBusyEnabledType <string>]
 [-CallRecordingExpirationDays <long>]
 [-CallingSpendUserLimit <long>]
 [-Confirm]
 [-Copilot <string>]
 [-EnableSpendLimits <boolean>]
 [-EnableWebPstnMediaBypass <Boolean>]
 [-Force]
 [-InboundFederatedCallRoutingTreatment <string>]
 [-InboundPstnCallRoutingTreatment <string>]
 [-LiveCaptionsEnabledTypeForCalling <string>]
 [-MusicOnHoldEnabledType <string>]
 [-PopoutAppPathForIncomingPstnCalls <string>]
 [-PopoutForIncomingPstnCalls <string>]
 [-PreventComplianceRecording <string>]
 [-PreventTollBypass <boolean>]
 [-SpamFilteringEnabledType <string>]
 [-VoiceSimulationInInterpreter <string>]
 [-RealTimeText <string>]
 [-RecordingAndTranscriptionAudioNotification <String>]
 [-ReportCall <String>]
 [-ExplicitRecordingConsent <string>]
 [-EnableRecordingAndTranscriptionCustomMessage <Boolean>]
 [-RecordingAndTranscriptionCustomMessageIdentifier <Guid>]
 [-AllowMeetingKnowledgeGeneration <Boolean>]
 [-VoicePhishingDetection <String>]
 [-WhatIf]
 [<CommonParameters>]

Parameters (42)

ParameterTypeRequiredWhat it controls
-AIInterpreter String Enables the user to use the AI Interpreter related features
-AllowCallForwardingToPhone Boolean Enables the user to configure in the Microsoft Teams client call forwarding or simultaneous ringing of inbound calls to any phone number.
-AllowCallForwardingToUser Boolean Enables the user to configure in the Microsoft Teams client call forwarding or simultaneous ringing of inbound calls to other users in your tenant.
-AllowCallGroups Boolean Enables the user to configure call groups in the Microsoft Teams client and that inbound calls should be routed to call groups.
-AllowCallRedirect String Setting this parameter enables local call redirection for SIP devices connecting via the Microsoft Teams SIP gateway.
-AllowCloudRecordingForCalls Boolean Determines whether cloud recording is allowed in a user's 1:1 Teams or PSTN calls. Set this to True to allow the user to be able to record 1:1 calls. Set this to False to prohibit the user from recording 1:1 calls.
-AllowDelegation Boolean Enables the user to configure delegation in the Microsoft Teams client and that inbound calls to be routed to delegates; allows delegates to make outbound calls on behalf of the users for whom they have delegated permissions.
-AllowPrivateCalling Boolean Controls all calling capabilities in Teams. Turning this off will turn off all calling functionality in Teams. If you use Skype for Business for calling, this policy will not affect calling functionality in Skype for...
-AllowSIPDevicesCalling Boolean Determines whether the user is allowed to use a SIP device for calling on behalf of a Teams client.
-AllowTranscriptionForCalling Boolean Determines whether post-call transcriptions are allowed. Set this to True to allow. Set this to False to prohibit.
-AllowVoicemail String Enables inbound calls to be routed to voicemail.
-AllowWebPSTNCalling Object Allows PSTN calling from the Teams web client.
-AutoAnswerEnabledType String Allow admins to enable or disable Auto-answer settings for users.
-BusyOnBusyEnabledType String Setting this parameter lets you configure how incoming calls are handled when a user is already in a call or conference or has a call placed on hold.
-CallingSpendUserLimit Long The maximum amount a user can spend on outgoing PSTN calls, including all calls made through Pay-as-you-go Calling Plans and any overages on plans with bundled minutes.
-CallRecordingExpirationDays Long Sets the expiration of the recorded 1:1 calls. Default is 60 days.
-Confirm SwitchParameter Prompts you for confirmation before running the cmdlet.
-Copilot String Setting this parameter lets you control how Copilot is used during calls and if transcription is needed to be turned on and saved after the call.
-Description String Enables administrators to provide explanatory text about the calling policy. For example, the Description might indicate the users to whom the policy should be assigned.
-EnableSpendLimits Boolean This setting allows an admin to enable or disable spend limits on PSTN calls for their user base.
-EnableWebPstnMediaBypass Boolean Determines if MediaBypass is enabled for PSTN calls on specified Web platforms.
-Force SwitchParameter Suppresses any confirmation prompts that would otherwise be displayed before making changes.
-Identity String Name of the policy instance being created.
-InboundFederatedCallRoutingTreatment String Setting this parameter lets you control how inbound federated calls should be routed.
-InboundPstnCallRoutingTreatment String Setting this parameter lets you control how inbound PSTN calls should be routed.
-LiveCaptionsEnabledTypeForCalling String Determines whether real-time captions are available for the user in Teams calls.
-MusicOnHoldEnabledType String Setting this parameter allows you to turn on or turn off the music on hold when a caller is placed on hold.
-PopoutAppPathForIncomingPstnCalls String Setting this parameter allows you to set the PopoutForIncomingPstnCalls setting's URL path of the website to launch upon receiving incoming PSTN calls. This parameter accepts an HTTPS URL with less than 1024...
-PopoutForIncomingPstnCalls String Setting this parameter allows you to control the tenant users' ability to launch an external website URL automatically in the browser window upon incoming PSTN calls for specific users or user groups. Valid options...
-PreventComplianceRecording String Controls whether Compliance Recording (CR)-enabled users are blocked from joining calls owned by the policy-assigned user. When set to `None`, no restriction is applied and compliance recording operates as configured...
-PreventTollBypass Boolean Setting this parameter to True will send calls through PSTN and incur charges rather than going through the network and bypassing the tolls.
-RealTimeText String Allows users to use real time text during a call, allowing them to communicate by typing their messages in real time.
-RecordingAndTranscriptionAudioNotification String Policy to control whether audio notifications will be played when recording or transcription starts/stops for applied users/groups.
-ReportCall String Controls if the Report call toggle should show up in calling settings for a tenant.
-SpamFilteringEnabledType String Determines if spam detection is enabled for inbound PSTN calls.
-VoiceSimulationInInterpreter String Enables the user to use the voice simulation feature while being AI interpreted.
-ExplicitRecordingConsent String This setting controls whether users must provide or obtain explicit consent before recording a 1:1 PSTN or Teams call. When enabled, both parties will receive a notification, and consent must be given before recording starts.
-EnableRecordingAndTranscriptionCustomMessage Boolean
-RecordingAndTranscriptionCustomMessageIdentifier Guid
-AllowMeetingKnowledgeGeneration Boolean This policy controls whether meeting knowledge generation is allowed for calling when the user starts recording/transcript/copilot.
-VoicePhishingDetection String The Voice Phishing Detection policy enables AI-based detection of voice phishing (vishing) attempts during live inbound Microsoft Teams calls.
-WhatIf SwitchParameter Shows what would happen if the cmdlet runs. The cmdlet is not run.

Reference facts derived from Microsoft documentation, © Microsoft, licensed CC BY 4.0; restructured with original guidance by serv365.ai.