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

Modifies an existing trunk configuration that defines the relationship between a Mediation Server and a Service Provider.

Syntax


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

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


Set-CsTrunkConfiguration [-ConcentratedTopology <Nullable>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-EnableBypass <Nullable>] [-EnableMobileTrunkSupport <Nullable>] [-EnableReferSupport <Nullable>] [-EnableSessionTimer <Nullable>] [-EnableSignalBoost <Nullable>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-MaxEarlyDialogs <Nullable>] [-OutboundTranslationRulesList <PSListModifier>] [-RemovePlusFromUri <Nullable>] [-RTCPActiveCalls <Nullable>] [-RTCPCallsOnHold <Nullable>] [-SRTPMode <Nullable>] [-WhatIf [<SwitchParameter>]]

Set-CsTrunkConfiguration [-ConcentratedTopology <Nullable>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-EnableBypass <Nullable>] [-EnableMobileTrunkSupport <Nullable>] [-EnableReferSupport <Nullable>] [-EnableSessionTimer <Nullable>] [-EnableSignalBoost <Nullable>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-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.
Instance	Optional	PSObject	Allows you to pass a reference to an object to the cmdlet rather than set individual parameter values. This parameter requires an object of type Microsoft.Rtc.Management.WritableConfig.Settings.TrunkConfiguration.TrunkConfiguration.
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 modified directly with this cmdlet, it is recommended that you modify the outbound translation rules with the Set-CsOutboundTranslationRule cmdlet. Set-CsOutboundTranslationRule will modify the rule, and these modifications will be automatically reflected in the trunk configuration. To modify the trunk configuration by adding a new outbound translation rule, call the New-CsOutboundTranslationRule cmdlet; the new rule will be added 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 modify a 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.

Return Types

This cmdlet does not return a value; it modifies an object of type Microsoft.Rtc.Management.WritableConfig.Settings.TrunkConfiguration.TrunkConfiguration.

Examples

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

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

This example modifies a trunk configuration with the Identity site:Redmond to enable media bypass. Media bypass is enabled by assigning the value $True to the EnableBypass parameter. The remaining properties for this configuration will retain their existing values.

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

	Copy Code
Set-CsOutboundTranslationRule -Identity site:Redmond/OTR1 -Translation "$1"

This example modifies an outbound translation rule defined for the trunk configuration with the Identity site:Redmond. Notice that we don’t actually make a call to the Set-CsTrunkConfiguration cmdlet to make this change. Changes made using Set-CsOutboundTranslationRule will be automatically reflected in the trunk configuration with an Identity matching the first part of the Identity of the outbound translation rule.

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

	Copy Code
Get-CsTrunkConfiguration -Filter site:* \| Set-CsTrunkConfiguration -SRTPMode "Optional"

Example 3 sets the SRTPMode for all trunk configurations defined at the site scope to Optional. The first part of the command is a call to the Get-CsTrunkConfiguration cmdlet that uses the Filter parameter to retrieve all trunk configurations with an Identity beginning with site:, meaning all trunk configurations defined at the site level. This collection of configurations is then piped to the Set-CsTrunkConfiguration cmdlet, which sets the SRTPMode property of each to Optional.