Commands › Microsoft Teams

New-CsTeamsCallingPolicy

Microsoft Teams MicrosoftTeams New-*

Use this cmdlet to create a new instance of a Teams Calling Policy.

Quick start script

# New-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)
New-CsTeamsCallingPolicy  -WhatIf
New-CsTeamsCallingPolicy

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

Syntax

New-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>]
 [-CallingSpendUserLimit <long>]
 [-CallRecordingExpirationDays <long>]
 [-Confirm]
 [-Copilot <string>]
 [-Description <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>]
 [-AllowMeetingKnowledgeGeneration <Boolean>]
 [-VoicePhishingDetection <String>]
 [-WhatIf]
 [-EnableRecordingAndTranscriptionCustomMessage <Boolean>]
 [-RecordingAndTranscriptionCustomMessageIdentifier <Guid>]
 [<CommonParameters>]

Parameters (42)

Parameter	Type	What 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 Team web client.
-AutoAnswerEnabledType	String	Setting this parameter allows you to enable or disable auto-answer for incoming meeting invites on Teams Phones. This setting applies only to incoming meeting invites and does not include support for other call types.
-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 Spam filtering mode.
-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 Teams call. When enabled, both parties will receive a notification, and consent must be given before recording starts.
-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.
-EnableRecordingAndTranscriptionCustomMessage	Boolean
-RecordingAndTranscriptionCustomMessageIdentifier	Guid	### CommonParameters This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction,...

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