Set-CsTeamsCallingPolicy

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

Syntax

Set-CsTeamsCallingPolicy
   [-Identity] <string>
   [-AllowCallForwardingToPhone <boolean>]
   [-AllowCallForwardingToUser <boolean>]
   [-AllowCallGroups <boolean>]
   [-AllowCallRedirect <string>]
   [-AllowCloudRecordingForCalls <boolean>]
   [-AllowDelegation <boolean>]
   [-AllowPrivateCalling <boolean>]
   [-AllowSIPDevicesCalling <boolean>]
   [-AllowTranscriptionForCalling <boolean>]
   [-AllowVoicemail <string>]
   [-AllowWebPSTNCalling <boolean>]
   [-BusyOnBusyEnabledType <string>]
   [-CallRecordingExpirationDays <long>]
   [-Confirm]
   [-Force]
   [-Copilot] <string>]
   [-InboundFederatedCallRoutingTreatment <string>]
   [-InboundPstnCallRoutingTreatment <string>]
   [-LiveCaptionsEnabledTypeForCalling <string>]
   [-MusicOnHoldEnabledType <string>]
   [-PopoutAppPathForIncomingPstnCalls <string>]
   [-PopoutForIncomingPstnCalls <string>]
   [-PreventTollBypass <boolean>]
   [-SpamFilteringEnabledType <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 set values in a given Calling Policy instance.

Only the parameters specified are changed. Other parameters keep their existing values.

Examples

Example 1

PS C:\> Set-CsTeamsCallingPolicy -Identity Global -AllowPrivateCalling $true

Sets the value of the parameter AllowPrivateCalling in the Global (default) Teams Calling Policy instance.

Example 2

PS C:\> Set-CsTeamsCallingPolicy -Identity HRPolicy -LiveCaptionsEnabledTypeForCalling Disabled

Sets the value of the parameter LiveCaptionsEnabledTypeForCalling to Disabled in the Teams Calling Policy instance called HRPolicy.

Parameters

-AllowCallForwardingToPhone

Enables the user to configure in the Microsoft Teams client call forwarding or simultaneous ringing of inbound calls to any phone number.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Microsoft Teams

-AllowCallForwardingToUser

Enables the user to configure in the Microsoft Teams client call forwarding or simultaneous ringing of inbound calls to other users in your tenant.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Microsoft Teams

-AllowCallGroups

Enables the user to configure call groups in the Microsoft Teams client and that inbound calls should be routed to call groups.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Microsoft Teams

-AllowCallRedirect

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.
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Microsoft Teams

-AllowCloudRecordingForCalls

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.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Microsoft Teams

-AllowDelegation

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.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Microsoft Teams

-AllowPrivateCalling

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.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Microsoft Teams

-AllowSIPDevicesCalling

Determines whether the user is allowed to use a SIP device for calling on behalf of a Teams client.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Microsoft Teams

-AllowTranscriptionForCalling

Determines whether post-call transcriptions are allowed. Set this to True to allow. Set this to False to prohibit.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Microsoft Teams

-AllowVoicemail

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.
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Microsoft Teams

-AllowWebPSTNCalling

Allows PSTN calling from the Teams web client.

Type:Object
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Microsoft Teams

-BusyOnBusyEnabledType

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.
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Microsoft Teams

-CallRecordingExpirationDays

Sets the expiration of the recorded 1:1 calls. Default is 60 days.

Type:Long
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Microsoft Teams

-Confirm

Prompts you for confirmation before running the cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Microsoft Teams

-Copilot

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.
Type:String
Position:Named
Default value:Enabled
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Microsoft Teams

-Description

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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Microsoft Teams

-Force

Suppresses any confirmation prompts that would otherwise be displayed before making changes.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Microsoft Teams

-Identity

Name of the policy instance being created.

Type:String
Position:1
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InboundFederatedCallRoutingTreatment

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.

Type:String
Position:Named
Default value:RegularIncoming
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Microsoft Teams

-InboundPstnCallRoutingTreatment

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: Users can determine their PSTN call routing choice from call settings in the Teams app.

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.

Type:String
Position:Named
Default value:RegularIncoming
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Microsoft Teams

-LiveCaptionsEnabledTypeForCalling

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.
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Microsoft Teams

-MusicOnHoldEnabledType

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.
Type:String
Position:Named
Default value:Enabled
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Microsoft Teams

-PopoutAppPathForIncomingPstnCalls

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.

Type:String
Position:Named
Default value:""
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Microsoft Teams

-PopoutForIncomingPstnCalls

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.

Type:String
Position:Named
Default value:Disabled
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Microsoft Teams

-PreventTollBypass

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.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Microsoft Teams

-SpamFilteringEnabledType

Determines if spam detection is enabled for inbound PSTN calls.

Possible values:

  • Enabled: Spam detection is enabled. In case the inbound call is considered spam, the user will get a "Spam Likely" label in Teams.
  • Disabled: Spam detection is disabled.
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Microsoft Teams

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Microsoft Teams

Inputs

System.Management.Automation.PSObject

Outputs

System.Object