New-CsTrunkConfiguration
上一次修改主题： 2012-03-27
创建新的描述服务提供商的中继对等实体（如公用电话交换网 (PSTN) 网关、IP 公用交换机 (PBX) 或会话边界控制器 (SBC)）的设置的中继配置。
语法
New-CsTrunkConfiguration -Identity <XdsIdentity> [-ConcentratedTopology <$true | $false>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-EnableBypass <$true | $false>] [-EnableMobileTrunkSupport <$true | $false>] [-EnablePIDFLOSupport <$true | $false>] [-EnableReferSupport <$true | $false>] [-EnableSessionTimer <$true | $false>] [-EnableSignalBoost <$true | $false>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-MaxEarlyDialogs <UInt32>] [-OutboundTranslationRulesList <PSListModifier>] [-RemovePlusFromUri <$true | $false>] [-RTCPActiveCalls <$true | $false>] [-RTCPCallsOnHold <$true | $false>] [-SipResponseCodeTranslationRulesList <PSListModifier>] [-SRTPMode <Required | Optional | NotSupported>] [-WhatIf [<SwitchParameter>]]
详细说明
使用此 cmdlet 可创建适用于 PSTN 网关实体的新中继配置。每种配置包含中继对等实体（如服务提供商的 PSTN 网关、IP-PBX 或 SBC）的特定设置。这些设置配置如下内容：是否在此中继上启用媒体绕过，是否在特定条件下发送实时传输控制协议 (RTCP) 数据包，以及是否需要安全实时协议 (SRTP) 加密。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 New-CsTrunkConfiguration cmdlet：RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsTrunkConfiguration"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
必需 |
Xds 标识 |
包括中继配置作用域的唯一标识符。可以在 Site 作用域创建中继配置，对于 PSTN 网关服务，也可以在 Service 作用域创建中继配置。（默认情况下，全局配置已存在，不能删除或重新创建。）例如 site:Redmond（对于 site 作用域）或 PstnGateway:Redmond.litwareinc.com（对于 service 作用域）。 |
ConcentratedTopology |
可选 |
布尔值 |
此参数的值可确定是否存在一个已知的媒体端点。（例如，PSTN 网关就是一个已知的媒体端点，其中媒体终端与信号终端具有相同的 IP。）如果中继没有已知的媒体端点，则将该值设置为 False。 默认值：True |
Description |
可选 |
字符串 |
用于描述中继配置用途的字符串。 |
EnableBypass |
可选 |
布尔值 |
此参数的值可确定是否对该中继启用媒体绕过功能。将此值设置为 True 可启用绕过。请注意，为使媒体绕过功能成功发挥作用，PSTN 网关、SBC 和 PBX 必须支持某些功能，其中包括： - 能够接收针对邀请的分叉响应。 - Microsoft Lync Server 2010 客户端与媒体端点必须能够直接通信，而不经由中介服务器。 - 网关子网必须定义为与客户端的子网位于同一站点；如果位于不同站点，则不得使用具有限定带宽的 WAN 链路分隔这些站点。 仅在以下情况时才可以启用媒体绕过功能： - ConcentratedTopology 参数设置为 True - EnableReferSupport 参数设置为 False 且 RTCPActiveCalls 和 RTCPCallsOnHold 设置为 False，或 EnableReferSupport 设置为 True 请注意，如果 EnableBypass 为 True 且 EnableReferSupport 为 False，则随后传输的绕过呼叫将变为非绕过呼叫。 要使媒体绕过功能对特定中继起作用，需要在全局范围内启用该功能，并且需要对该中继启用该功能。使用 New-CsNetworkMediaBypassConfiguration cmdlet 可在全局范围内启用媒体绕过功能。 默认值：False |
EnableMobileTrunkSupport |
可选 |
布尔值 |
定义服务提供商是否为移动运营商。 默认值：False |
EnablePIDFLOSupport |
可选 |
布尔值 |
定义是否通过所定义的网关来路由具有状态信息数据格式位置对象 (PIDF-LO) 的紧急呼叫。如果要将紧急呼叫路由到已认证的紧急服务提供商，需将此参数设置为 True。（位置信息将随呼叫一起传输。） 默认值：False |
EnableReferSupport |
可选 |
布尔值 |
定义此中继是否支持接收来自中介服务器的 Refer 请求。 仅在以下情况时才可以启用媒体绕过功能： - ConcentratedTopology 参数设置为 True - EnableReferSupport 参数设置为 False 且 RTCPActiveCalls 和 RTCPCallsOnHold 设置为 False，或 EnableReferSupport 设置为 True 请注意，如果 EnableBypass 为 True 且 EnableReferSupport 为 False，则随后传输的绕过呼叫将变为非绕过呼叫。 默认值：True |
EnableSessionTimer |
可选 |
布尔值 |
指定是否启用会话计时器。会话计时器用于确定特定会话是否仍处于活动状态。 请注意，即使此参数设置为 False，但如果远程连接启用了会话计时器，也会应用会话计时器。在这种情况下，中介服务器将响应来自远程实体的会话计时器探查。 默认值：False |
EnableSignalBoost |
可选 |
布尔值 |
如果将此参数设置为 True，服务提供商的 PSTN 网关、IP-PBX 或 SBC 将提高发送给中介服务器或 Microsoft Lync Server 2010 客户端的语音流中的音量。如果将此值设置为 False，将在中介服务器（对于非绕过呼叫）或 Lync Server 2010 客户端（对于绕过呼叫）增大音量。 默认值：False |
MaxEarlyDialogs |
可选 |
Int64 |
服务提供商的 PSTN 网关、IP-PBX 或 SBC 可以接收的分叉响应的最大数目，这些响应是针对发送到中介服务器的邀请的。 默认值：20 |
OutboundTranslationRulesList |
可选 |
PSListModifier |
应用于由 Outbound Routing 处理的呼叫（路由到 PBX 或 PSTN 目标的呼叫）的电话号码转换规则的集合。 虽然可以通过此 cmdlet 直接创建该列表以及这些规则，但是建议您使用 New-CsOutboundTranslationRule cmdlet 创建出站转换规则，该 cmdlet 会创建规则并将其分配给作用域匹配的中继配置。 |
RemovePlusFromUri |
可选 |
布尔值 |
如果将此参数设置为 True，会导致中介服务器在将统一资源标识符 (URI) 发送到服务提供商之前删除 URI 的前导加号 (+)。 默认值：False |
RTCPActiveCalls |
可选 |
布尔值 |
此参数确定是否从服务提供商的 PSTN 网关、IP-PBX 或 SBC 对活动呼叫发送 RTCP 数据包。此情况下的活动呼叫是指允许媒体沿至少一个方向流动的呼叫。当 RTCPActiveCalls 设置为 True 时，如果中介服务器或 Lync Server 客户端在 30 秒后还没有收到 RTCP 数据包，将会终止呼叫。 请注意，如果对 Lync Server 元素中活动呼叫收到的 RTCP 媒体禁用检查，则将失去一种用于检测故障对等端的重要安全防护措施，因此应仅在必要时才禁用检查。 默认值：True |
RTCPCallsOnHold |
可选 |
布尔值 |
此参数确定是否通过中继，继续对置于等待状态且预计在任何方向都没有媒体数据包流动的呼叫发送 RTCP 数据包。如果在 Lync Server 客户端或中继上启用了呼叫等待音乐功能，此呼叫将被认为是活动呼叫，而该属性将被忽略。这种情况下可使用 RTCPActiveCalls 参数。 请注意，如果对 Lync Server 元素中活动呼叫收到的 RTCP 媒体禁用检查，则将失去一种用于检测故障对等端的重要安全防护措施，因此应仅在必要时才禁用检查。 默认值：True |
SipResponseCodeTranslationRulesList |
可选 |
PSListModifier |
SIP 响应代码转换规则列表，这些规则适用于从服务提供商的 PSTN 网关、IP-PBX 或 SBC 收到的响应代码。使用这些规则，管理员可以将通过中继收到的值在 400 与 699 之间的 SIP 响应代码映射到更符合 Lync Server 标准的新值。 您可直接使用此 cmdlet 创建该列表和相应规则。但是，建议您通过调用 New-CsSipResponseCodeTranslationRule cmdlet 来创建 SIP 响应代码转换规则。该 cmdlet 会创建规则并将其分配给作用域匹配的中继配置。 |
SRTPMode |
可选 |
SRTPMode |
此参数的值可确定对 SRTP 的支持级别，以保护中介服务器与服务提供商的 PSTN 网关、IP-PBX 或 SBC 之间的媒体流量。对于媒体绕过情况，该值必须与媒体配置中的 EncryptionLevel 设置兼容。可使用 New-CsMediaConfiguration 和 Set-CsMediaConfiguration cmdlet 设置媒体配置。 有效值： - Required：必须使用 SRTP 加密。 - Optional：如果网关支持 SRTP，将使用 SRTP。 - NotSupported:SRTP 加密不受支持，因此不使用该功能。 说明：仅当网关配置为使用传输层安全性 (TLS) 时，才会使用 SRTPMode。如果将网关配置为使用传输控制协议 (TCP)，则 SRTPMode 会在内部设置为 NotSupported。 默认值：Required |
Force |
可选 |
开关参数 |
在进行更改前取消可能另外显示的任何确认提示。 |
InMemory |
可选 |
开关参数 |
创建对象引用，但并不作为永久性更改实际提交对象。如果将使用此参数调用的 cmdlet 的输出分配给一个变量，您可以更改对象引用的属性，然后通过调用与此 cmdlet 匹配的 Set- cmdlet 提交这些更改。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况（无需实际执行命令）。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
无。
返回类型
创建一个类型为 Microsoft.Rtc.Management.WritableConfig.Settings.TrunkConfiguration.TrunkConfiguration 的对象。
示例
-------------------------- 示例 1 --------------------------
New-CsTrunkConfiguration -Identity site:Redmond
此示例创建 Identity 为 site:Redmond 的新中继配置。该新配置的其余属性将使用默认值进行填充。
-------------------------- 示例 2 --------------------------
New-CsTrunkConfiguration -Identity site:Redmond -EnableBypass $True
此示例创建 Identity 为 site:Redmond 的新中继配置并启用媒体绕过。媒体绕过功能是通过将值 $True 分配给 EnableBypass 参数来启用的。该新配置的其余属性将使用默认值进行填充。
-------------------------- 示例 3 --------------------------
New-CsTrunkConfiguration -Identity site:Redmond
New-CsOutboundTranslationRule -Identity site:Redmond/OTR1 -Pattern '^\+(\d{8})$' -Translation '9$1'
此示例创建 Identity 为 site:Redmond 的新中继配置，然后为该中继分配新的出站转换。此示例的第一行调用 New-CsTrunkConfiguration 创建使用默认设置的新中继配置。第二行调用 New-CsOutboundTranslationRule cmdlet。请注意分配给 Identity 的值：site:Redmond/OTR1。Identity 的第一部分 (site:Redmond) 定义应用规则的作用域。该作用域匹配新中继配置的 Identity，这意味着此规则将自动应用于该配置。该作用域后跟斜线 (/)，然后是一个字符串，该字符串是此规则的唯一名称（每个作用域可以包含多个规则）。之后，我们将值传递到 Pattern 和 Translation 参数以定义此规则。