New-CsTeamsCallingPolicy

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

Syntax

New-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>][-AutoAnswerEnabledType <string>]
   [-BusyOnBusyEnabledType <string>]
   [-CallRecordingExpirationDays <long>]
   [-Description <string>][-LiveCaptionsEnabledTypeForCalling <string>]
   [-MusicOnHoldEnabledType <string>]
   [-PopoutAppPathForIncomingPstnCalls <string>]
   [-PopoutForIncomingPstnCalls <string>]
   [-PreventTollBypass <boolean>]
   [-SpamFilteringEnabledType <string>][-WhatIf]
   [-Confirm]
   [<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

-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
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
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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Microsoft Teams

-AllowCallRedirect

Setting this parameter provides the ability to configure call redirection capabilities on Teams Phones. The valid options are: Enabled, Disabled, and UserOverride. When set to Enabled users will have the ability to redirect received calls. However, when set to Disabled the user will not have such ability. Note: The UserOverride option is not available for use. There's no UX implemented for its management.

Type:String
Position:Named
Default value:None
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
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
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
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
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
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, AlwaysDisabled, and UserOverride. When set to 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. When set to AlwaysEnabled, calls are always forwarded to voicemail on unanswered after ringing for thirty seconds, regardless of the unanswered call forward setting for the user. When set to 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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Microsoft Teams

-AllowWebPSTNCalling

Allows PSTN calling from the Team web client.

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

-AutoAnswerEnabledType

Setting this parameter allows you to enable or disable auto-answer for incoming meeting invites on Teams Phones. It is turned off by default. Valid options are Enabled and Disabled. This setting applies only to incoming meeting invites and does not include support for other call types.

Type:Enum
Position:Named
Default value:Disabled
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, Unanswered, and Disabled. When set to Enabled, new or incoming calls will be rejected with a busy signal. When set to Unanswered, the user's unanswered settings will take effect, such as routing to voicemail or forwarding to another user. Note: UserOverride option value is not available for use currently, if set it will be read as setting the value to Disabled.

Type:String
Position:Named
Default value:None
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
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
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
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
Accept pipeline input:False
Accept wildcard characters:False

-LiveCaptionsEnabledTypeForCalling

Determines whether real-time captions are available for the user in Teams calls. Set this to DisabledUserOverride to allow the user to turn on live captions. Set this to Disabled to prohibit.

Possible values:

  • DisabledUserOverride
  • Disabled
Type:String
Position:Named
Default value:None
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. It is turned on by default. Valid options are Enabled, Disabled, and UserOverride. For now, setting the value to UserOverride is the same as Enabled.

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

-PopoutAppPathForIncomingPstnCalls

Reserved for internal Microsoft use.

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

-PopoutForIncomingPstnCalls

Reserved for internal Microsoft use.

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

-SpamFilteringEnabledType

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

Outputs

System.Object