[This is preliminary documentation and is subject to change. Blank topics are included as placeholders.]

Creates a new trunk configuration that defines the relationship between a Mediation Server and a Service Provider.

Syntax

New-CsTrunkConfiguration -Identity <XdsIdentity> [-ConcentratedTopology <Nullable>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-EnableBypass <Nullable>] [-EnableMobileTrunkSupport <Nullable>] [-EnableReferSupport <Nullable>] [-EnableSessionTimer <Nullable>] [-EnableSignalBoost <Nullable>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-MaxEarlyDialogs <Nullable>] [-OutboundTranslationRulesList <PSListModifier>] [-RemovePlusFromUri <Nullable>] [-RTCPActiveCalls <Nullable>] [-RTCPCallsOnHold <Nullable>] [-SRTPMode <Nullable>] [-WhatIf [<SwitchParameter>]]

Parameters

Parameter Required Type Description

Identity

Required

XdsIdentity

A unique identifier that includes the scope of the trunk configuration. Trunk configuration can be at the Global or Site scope, or can be at the Service scope for a PSTN Gateway service.

ConcentratedTopology

Optional

Boolean

The value of this parameter determines whether there is a well-known media termination point. (An example of a well-known media termination point would be a PSTN Gateway where the media termination has the same IP as the signaling termination.) Set this value to False if the trunk does not have a well-known media termination point.

Default: True

Description

Optional

String

A string describing the purpose of the trunk configuration.

EnableBypass

Optional

Boolean

The value of this parameter determines whether media bypass is enabled for this trunk. You can set this value to True to enable bypass, but in order for the media bypass to work successfully gateways, Session Border Controllers (SBCs), and private branch exchanges (PBXs) must support certain capabilities, including:

- Unified Communications clients and the SBC at the Service Provider must be able to communicate directly without going through a Mediation Server.

- The SBC must support Refer exactly as specified for gateways (sending a triggered Invite to the Mediation Server using the fully qualified domain name [FQDN]).

- The SBC subnet must be defined as being at the same site as the client’s subnet.

If you want to define media bypass settings globally rather than per-trunk, use the New-CsNCSMediaBypassSetting cmdlet.

Default: False

EnableMobileTrunkSupport

Optional

Boolean

Defines whether the Service Provider is a mobile carrier.

Default: False

EnableReferSupport

Optional

Boolean

Defines whether this trunk supports receiving Refer requests from the Mediation Server.

Default: False

EnableSignalBoost

Optional

Boolean

When this parameter is set to True the PSTN Gateway, IP-PBX, or Session Border Controller (SBC) at the Service Provider will boost the audio packets that are sent to the Mediation Server.

Default: False

MaxEarlyDialogs

Optional

Int64

The maximum number of forked responses a PSTN Gateway, IP-PBX, or SBC at the Service Provider can receive to an Invite that it sent to the Mediation Server.

Default: 20

OutboundTranslationRulesList

Optional

PSListModifier

A collection of phone number translation rules that apply to calls handled by Outbound Routing (calls routed to PBX or PSTN destinations).

While this list and these rules can be created directly with this cmdlet, it is recommended that you create the outbound translation rules with the New-CsOutboundTranslationRule cmdlet, which will create the rule and assign it to the trunk configuration with the matching scope.

RemovePlusFromUri

Optional

Boolean

Setting this parameter to True will cause the Mediation Server to remove leading plus signs (+) from URIs before sending them on to the Service Provider.

Default: False

RTCPActiveCalls

Optional

Boolean

Default: True

RTCPCallsOnHold

Optional

Boolean

This parameter determines whether RTCP packets continue to be sent across the trunk for calls that have been placed on hold.

Default: True

SRTPMode

Optional

SRTPMode

The value of this parameter determines the level of support for secure real-time protocol (SRTP) to protect media traffic between the Mediation Server and the gateway or PBX.

Valid values:

- Required: SRTP encryption must be used.

- Optional: SRTP will be used if the service provider supports it.

- NotSupported: SRTP encryption is not supported and therefore will not be used.

Default: Required

Full data type: Microsoft.Rtc.Management.WritableConfig.Settings.TrunkConfiguration.SRTPMode

InMemory

Optional

SwitchParameter

Creates an object reference without actually committing the object as a permanent change. If you assign the output of this cmdlet called with this parameter to a variable, you can make changes to the properties of the object reference and then commit those changes by calling this cmdlet’s matching Set- cmdlet.

Confirm

Optional

SwitchParameter

Prompts you for confirmation before executing the command.

WhatIf

Optional

SwitchParameter

Describes what would happen if you executed the command without actually executing the command.

Detailed Description

Use this cmdlet to create a new trunking configuration for a Mediation Server. Each configuration contains specific settings defining the relationship and capabilities between the Mediation Server and the public switched telephone network (PSTN) Gateway, IP-PBX, or Session Border Controller (SBC) at the Service Provider. These settings configure such things as whether media bypass is enabled on this trunk, whether RTCP packets are sent under certain conditions, and whether to require secure real-time protocol (SRTP) encryption.

Available scopes: Global, Site, Service (PstnGateway only)

Return Types

Creates an object of type Microsoft.Rtc.Management.WritableConfig.Settings.TrunkConfiguration.TrunkConfiguration.

Examples

-------------------------- Example 1 ------------------------

Copy Code
New-CsTrunkConfiguration -Identity site:Redmond

This example creates a new trunk configuration with the Identity site:Redmond. The remaining properties for this new configuration will be populated with default values.

-------------------------- Example 2 ------------------------

Copy Code
New-CsTrunkConfiguration -Identity site:Redmond -EnableBypass $True

This example creates a new trunk configuration with the Identity site:Redmond and enables media bypass. Media bypass is enabled by assigning the value $True to the EnableBypass parameter. The remaining properties for this new configuration will be populated with default values.

-------------------------- Example 3 ------------------------

Copy Code
New-CsTrunkConfiguration -Identity site:Redmond
New-CsOutboundTranslationRule -Identity site:Redmond/OTR1 -Pattern "^\+(\d{8})$" -Translation "9$1"

This example creates a new trunk configuration with the Identity site:Redmond, then assigns a new outbound translation to that trunk. The first line of the example calls New-CsTrunkConfiguration to create the new trunk configuration with default settings. The second line calls the New-CsOutboundTranslationRule cmdlet. Notice the value assigned to the Identity: site:Redmond/OTR1. The first part of the Identity (site:Redmond) defines the scope at which the rule is applied. This scope matches the Identity of the new trunk configuration, which means this rule will automatically be applied to that configuration. The scope is followed by a slash (/) then a string, which is simply a unique name for this rule (there can be more than one rule per scope). After that we simply pass values to the Pattern and Translation parameters to define this rule.