New-CsTeamsCallingPolicy
Use this cmdlet to create a new instance of a Teams Calling Policy.
Syntax
Identity (Default)
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>]
[-PreventTollBypass <boolean>]
[-SpamFilteringEnabledType <string>]
[-VoiceSimulationInInterpreter <string>]
[-RealTimeText <string>]
[-ExplicitRecordingConsent <string>]
[-WhatIf]
[<CommonParameters>]
Description
The Teams Calling Policy controls which calling and call forwarding features are available to users in Microsoft Teams. This cmdlet allows admins to create new policy instances.
Examples
Example 1
PS C:\> New-CsTeamsCallingPolicy -Identity Sales -AllowPrivateCalling $false
The cmdlet create the policy instance Sales and sets the value of the parameter AllowPrivateCalling to False. The rest of the parameters are set to the corresponding values in the Global policy instance.
Parameters
-AIInterpreter
Applicable: Microsoft Teams
Note
This feature has not been released yet and will have no changes if it is enabled or disabled.
Enables the user to use the AI Interpreter related features
Possible values:
- Disabled
- Enabled
Parameter properties
| Type: | String |
| Default value: | Enabled |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-AllowCallForwardingToPhone
Applicable: Microsoft Teams
Enables the user to configure in the Microsoft Teams client call forwarding or simultaneous ringing of inbound calls to any phone number.
Parameter properties
| Type: | Boolean |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-AllowCallForwardingToUser
Applicable: Microsoft Teams
Enables the user to configure in the Microsoft Teams client call forwarding or simultaneous ringing of inbound calls to other users in your tenant.
Parameter properties
| Type: | Boolean |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-AllowCallGroups
Applicable: Microsoft Teams
Enables the user to configure call groups in the Microsoft Teams client and that inbound calls should be routed to call groups.
Parameter properties
| Type: | Boolean |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-AllowCallRedirect
Applicable: Microsoft Teams
Setting this parameter enables local call redirection for SIP devices connecting via the Microsoft Teams SIP gateway.
Valid options are:
Enabled: Enables the user to redirect an incoming call.
Disabled: The user is not enabled to redirect an incoming call.
UserOverride: This option is not available for use.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-AllowCloudRecordingForCalls
Applicable: Microsoft Teams
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.
Parameter properties
| Type: | Boolean |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-AllowDelegation
Applicable: Microsoft Teams
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.
Parameter properties
| Type: | Boolean |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-AllowPrivateCalling
Applicable: Microsoft Teams
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 Business.
Parameter properties
| Type: | Boolean |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-AllowSIPDevicesCalling
Applicable: Microsoft Teams
Determines whether the user is allowed to use a SIP device for calling on behalf of a Teams client.
Parameter properties
| Type: | Boolean |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-AllowTranscriptionForCalling
Applicable: Microsoft Teams
Determines whether post-call transcriptions are allowed. Set this to True to allow. Set this to False to prohibit.
Parameter properties
| Type: | Boolean |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-AllowVoicemail
Applicable: Microsoft Teams
Enables inbound calls to be routed to voicemail.
Valid options are:
- AlwaysEnabled: Calls are always forwarded to voicemail on unanswered after ringing for thirty seconds, regardless of the unanswered call forward setting for the user.
- AlwaysDisabled: Calls are never routed to voicemail, regardless of the call forward or unanswered settings for the user. Voicemail isn't available as a call forwarding or unanswered setting in Teams.
- UserOverride: Calls are forwarded to voicemail based on the call forwarding and/or unanswered settings for the user.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-AllowWebPSTNCalling
Applicable: Microsoft Teams
Allows PSTN calling from the Team web client.
Parameter properties
| Type: | Object |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-AutoAnswerEnabledType
Applicable: Microsoft Teams
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.
Valid options are:
- Enabled: Auto-answer is enabled.
- Disabled: Auto-answer is disabled. This is the default setting.
Parameter properties
| Type: | String |
| Default value: | Disabled |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-BusyOnBusyEnabledType
Applicable: Microsoft Teams
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.
Valid options are:
- Enabled: New or incoming calls will be rejected with a busy signal.
- Unanswered: The user's unanswered settings will take effect, such as routing to voicemail or forwarding to another user.
- Disabled: New or incoming calls will be presented to the user.
- UserOverride: Users can set their busy options directly from call settings in Teams app.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-CallingSpendUserLimit
Applicable: Microsoft Teams
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.
Possible values: any positive integer
Parameter properties
| Type: | Long |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-CallRecordingExpirationDays
Applicable: Microsoft Teams
Sets the expiration of the recorded 1:1 calls. Default is 60 days.
Parameter properties
| Type: | Long |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-Confirm
Applicable: Microsoft Teams
Prompts you for confirmation before running the cmdlet.
Parameter properties
| Type: | SwitchParameter |
| Default value: | False |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | cf |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-Copilot
Applicable: Microsoft Teams
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.
Valid options are:
- Enabled: Copilot can work with or without transcription during calls. This is the default value.
- EnabledWithTranscript: Copilot will only work when transcription is enabled during calls.
- Disabled: Copilot is disabled for calls.
Parameter properties
| Type: | String |
| Default value: | Enabled |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-Description
Applicable: Microsoft Teams
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.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-EnableSpendLimits
Applicable: Microsoft Teams
This setting allows an admin to enable or disable spend limits on PSTN calls for their user base.
Possible values:
- True
- False
Parameter properties
| Type: | Boolean |
| Default value: | False |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-EnableWebPstnMediaBypass
Determines if MediaBypass is enabled for PSTN calls on specified Web platforms.
Parameter properties
| Type: | Boolean |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-ExplicitRecordingConsent
Applicable: Microsoft Teams
Note
This feature has not been released yet and will have no changes if it is enabled or disabled.
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.
Possible values:
- Enabled: Requires users to give and obtain explicit consent before starting a call recording.
- Disabled: Users are not required to obtain explicit consent before recording starts.
Parameter properties
| Type: | String |
| Default value: | Disabled |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-Force
Applicable: Microsoft Teams
Suppresses any confirmation prompts that would otherwise be displayed before making changes.
Parameter properties
| Type: | SwitchParameter |
| Default value: | False |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | wi |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-Identity
Name of the policy instance being created.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | 1 |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-InboundFederatedCallRoutingTreatment
Applicable: Microsoft Teams
Setting this parameter lets you control how inbound federated calls should be routed.
Valid options are:
RegularIncoming: No changes are made to default inbound routing. This is the default setting.
Unanswered: The inbound federated call will be routed according to the called user's unanswered call settings and the call will not be presented to the called user. The called user will see a missed call notification. If the called user has not enabled unanswered call settings the call will be disconnected.
Voicemail: The inbound federated call will be routed directly to the called user's voicemail and the call will not be presented to the user. If the called user does not have voicemail enabled the call will be disconnected.
Setting this parameter to Unanswered or Voicemail will have precedence over other call forwarding settings like call forward/simultaneous ringing to delegate, call groups, or call forwarding.
Parameter properties
| Type: | String |
| Default value: | RegularIncoming |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-InboundPstnCallRoutingTreatment
Applicable: Microsoft Teams
Setting this parameter lets you control how inbound PSTN calls should be routed.
Valid options are:
- RegularIncoming: No changes are made to default inbound routing. This is the default setting.
- Unanswered: The inbound PSTN call will be routed according to the called user's unanswered call settings and the call will not be presented to the called user. The called user will see a missed call notification. If the called user has not enabled unanswered call settings the call will be disconnected.
- Voicemail: The inbound PSTN call will be routed directly to the called user's voicemail and the call will not be presented to the user. If the called user does not have voicemail enabled the call will be disconnected.
- UserOverride: For now, setting the value to UserOverride is the same as RegularIncoming.
Setting this parameter to Unanswered or Voicemail will have precedence over other call forwarding settings like call forward/simultaneous ringing to delegate, call groups, or call forwarding.
Parameter properties
| Type: | String |
| Default value: | RegularIncoming |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-LiveCaptionsEnabledTypeForCalling
Applicable: Microsoft Teams
Determines whether real-time captions are available for the user in Teams calls.
Valid options are:
- DisabledUserOverride: Allows the user to turn on live captions.
- Disabled: Prohibits the user from turning on live captions.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-MusicOnHoldEnabledType
Applicable: Microsoft Teams
Setting this parameter allows you to turn on or turn off the music on hold when a caller is placed on hold.
Valid options are:
- Enabled: Music on hold is enabled. This is the default.
- Disabled: Music on hold is disabled.
- UserOverride: For now, setting the value to UserOverride is the same as Enabled.
Parameter properties
| Type: | String |
| Default value: | Enabled |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-PopoutAppPathForIncomingPstnCalls
Applicable: Microsoft Teams
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 characters. The URL can contain a {phone} placeholder that is replaced with the caller's PSTN number in E.164 format when launched.
Parameter properties
| Type: | String |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-PopoutForIncomingPstnCalls
Applicable: Microsoft Teams
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 are Enabled and Disabled.
Parameter properties
| Type: | String |
| Default value: | Disabled |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-PreventTollBypass
Applicable: Microsoft Teams
Setting this parameter to True will send calls through PSTN and incur charges rather than going through the network and bypassing the tolls.
Note
Do not set this parameter to True for Calling Plan or Operator Connect users as it will prevent successful call routing. This setting only works with Direct Routing which is configured to handle location-based routing restrictions.
Parameter properties
| Type: | Boolean |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-RealTimeText
Applicable: Microsoft Teams
Allows users to use real time text during a call, allowing them to communicate by typing their messages in real time.
Possible Values:
- Enabled: User is allowed to turn on real time text.
- Disabled: User is not allowed to turn on real time text.
Parameter properties
| Type: | String |
| Default value: | Enabled |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-SpamFilteringEnabledType
Applicable: Microsoft Teams
Determines Spam filtering mode.
Possible values:
- Enabled: Spam Filtering is fully enabled. Both Basic and Captcha Interactive Voice Response (IVR) checks are performed. In case the call is considered spam, the user will get a "Spam Likely" notification in Teams.
- Disabled: Spam Filtering is completely disabled. No checks are performed. A "Spam Likely" notification will not appear.
- EnabledWithoutIVR: Spam Filtering is partially enabled. Captcha IVR checks are disabled. A "Spam Likely" notification will appear. A call might get dropped if it gets a high score from Basic checks.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-VoiceSimulationInInterpreter
Applicable: Microsoft Teams
Note
This feature has not been released yet and will have no changes if it is enabled or disabled.
Enables the user to use the voice simulation feature while being AI interpreted.
Possible Values:
- Disabled
- Enabled
Parameter properties
| Type: | String |
| Default value: | Disabled |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-WhatIf
Applicable: Microsoft Teams
Shows what would happen if the cmdlet runs. The cmdlet is not run.
Parameter properties
| Type: | SwitchParameter |
| Default value: | False |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | wi |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.