Set-CsTrunkConfiguration
上一次修改主题: 2012-03-25
修改描述中继对等实体(如服务提供商的公用电话交换网 (PSTN) 网关、IP 公共交换机 (IP-PBX) 或会话边界控制器 (SBC))设置的现有中继配置。
语法
Set-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>] [-MaxEarlyDialogs <UInt32>] [-OutboundTranslationRulesList <PSListModifier>] [-RemovePlusFromUri <$true | $false>] [-RTCPActiveCalls <$true | $false>] [-RTCPCallsOnHold <$true | $false>] [-SipResponseCodeTranslationRulesList <PSListModifier>] [-SRTPMode <Required | Optional | NotSupported>] [-WhatIf [<SwitchParameter>]]
Set-CsTrunkConfiguration [-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>] [-Instance <PSObject>] [-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:默认情况下,以下各组的成员有权在本地运行 Set-CsTrunkConfiguration cmdlet:RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表(包括您自己创建的任何自定义 RBAC 角色),请从 Windows PowerShell 提示符处运行以下命令:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsTrunkConfiguration"}
参数
参数 | 必需 | 类型 | 描述 |
---|---|---|---|
Identity |
必需 |
Xds 标识 |
包括中继配置作用域的唯一标识符。对于 PSTN 网关服务,中继配置可能存在于 Global 作用域、Site 作用域或 Service 作用域。例如 site:Redmond(对于 site 作用域)或 PstnGateway:Redmond.litwareinc.com(对于 service 作用域)。 |
Instance |
可选 |
TrunkConfiguration |
允许您将对对象的引用传递到 cmdlet,而不是设置单个参数值。 此参数要求使用 Microsoft.Rtc.Management.WritableConfig.Settings.TrunkConfiguration.TrunkConfiguration 类型的对象,可通过调用 Get-CsTrunkConfiguration cmdlet 来检索该对象。 |
ConcentratedTopology |
可选 |
布尔值 |
此参数的值可确定是否存在一个已知的媒体端点。(例如,PSTN 网关就是一个已知的媒体端点,其中媒体终端与信号终端具有相同的 IP。)如果中继没有已知的媒体端点,则将该值设置为 False。 默认值:True |
Description |
可选 |
字符串 |
用于描述中继配置用途的字符串。 |
EnableBypass |
可选 |
布尔值 |
此参数的值可确定是否对该中继启用媒体绕过功能。将此值设置为 True 可启用绕过。请注意,为使媒体绕过功能成功发挥作用,PSTN 网关、SBC 和 PBX 必须支持某些功能,其中包括: - 能够接收针对邀请的分叉响应。 - 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 可以直接修改该列表和这些规则,但我们建议您使用 Set-CsOutboundTranslationRule cmdlet 修改出站转换规则。Set-CsOutboundTranslationRule 将修改该规则,并且所做的修改会自动反映在中继配置中。要通过添加新的出站转换规则来修改中继配置,请调用 New-CsOutboundTranslationRule cmdlet;新规则将添加到具有匹配作用域的中继配置中。 |
RemovePlusFromUri |
可选 |
布尔值 |
如果将此参数设置为 True,会导致中介服务器在将统一资源标识符 (Uniform Resources Identifier, 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 |
可选 |
开关参数 |
在进行更改前取消可能另外显示的任何确认提示。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况(无需实际执行命令)。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
Microsoft.Rtc.Management.WritableConfig.Settings.TrunkConfiguration.TrunkConfiguration 对象。接受通过管道传递的中继配置对象的输入。
返回类型
此 cmdlet 不会返回值;它会修改一个类型为 Microsoft.Rtc.Management.WritableConfig.Settings.TrunkConfiguration.TrunkConfiguration 的对象。
示例
-------------------------- 示例 1 --------------------------
Set-CsTrunkConfiguration -Identity site:Redmond -EnableBypass $True
此示例修改 Identity 为 site:Redmond 的中继配置以启用媒体绕过功能。媒体绕过功能是通过将值 $True 分配给 EnableBypass 参数来启用的。此配置的其余属性将保留其现有值。
-------------------------- 示例 2 --------------------------
Set-CsOutboundTranslationRule -Identity site:Redmond/OTR1 -Translation '$1'
此示例修改为中继配置(Identity 为 site:Redmond)定义的出站转换规则。请注意,实际上我们并没有调用 Set-CsTrunkConfiguration cmdlet 来进行此更改。使用 Set-CsOutboundTranslationRule 进行的更改会自动反映在 Identity 与出站转换规则 Identity 的作用域部分匹配的中继配置中。
-------------------------- 示例 3 --------------------------
Get-CsTrunkConfiguration -Filter site:* | Set-CsTrunkConfiguration -SRTPMode "Optional"
示例 3 将在 site 作用域定义的所有中继配置的 SRTPMode 设置为 Optional。该命令的第一部分调用使用 Filter 参数的 Get-CsTrunkConfiguration cmdlet,以检索 Identity 以 site: 开头的所有中继配置,即在站点级别定义的所有中继配置。然后,将该配置集合通过管道传递到 Set-CsTrunkConfiguration cmdlet,后者会将每个配置的 SRTPMode 属性设置为 Optional。
-------------------------- 示例 4 ------------------------
Set-CsTrunkConfiguration -Identity site:Redmond -EnablePIDFLOSupport $True
示例 4 将修改 Trunk 配置(Identity 为 site:Redmond),以启用 PIDF-LO 支持。默认情况下,EnablePIDFLOSupport 参数为 False。在该示例中我们将该值设置为 True,以启用紧急呼叫的位置支持。必须将 EnablePIDFLOSupport 设置为 True,出站路由应用程序才能将位置信息发送到 Trunk。