Remove-CsSipResponseCodeTranslationRule
上一次修改主题： 2012-03-26
删除 SIP 响应代码转换规则。通过这些规则，管理员可以将值介于 400 和 699 之间的 SIP 响应代码映射到 Microsoft Lync Server 2010 使用的值。
语法
Remove-CsSipResponseCodeTranslationRule -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
详细说明
SIP 中继提供了一种将 IP 电话 (VoIP) 网络（例如，企业语音）与公用电话交换网 (PSTN) 连接起来的方法。在 Lync Server 2010 中，中介服务器使用中继对等方与 PSTN 网络进行交互。在 PSTN 网络上，传出呼叫失败时，会自动生成 ISDN 用户部分 (ISUP) 原因代码。例如，PSTN 网关可能会发送原因代码 34，指示不存在可用于完成呼叫的任何电路或信道。当中介服务器中继对等实体接收到该 ISUP 原因代码时，会将该代码转换为 SIP 响应代码，然后自行将其发送到中介服务器。接下来，Lync Server 会使用这些响应代码做出其出站路由决定。例如，无法正常运行的网关可能自动分配有“非优先”状态；这样可以尽量避免使用无法正常运行的网关，从而提高成功完成呼叫的机会。
但是，并非所有网关都会将建议的 ISUP 原因代码用于 Lync Server 使用的 SIP 响应代码映射。对于这些网关，管理员可以使用 CsSipResponseCodeTranslationRule cmdlet 将网关 SIP 响应代码（如果提供了 ISUP 原因代码，则结合该代码）映射为 Lync Server 使用的 SIP 响应代码。例如，网关可能会将 ISUP 原因代码 34（“没有可用的电路/信道”）映射到 SIP 响应代码 486（“此处正忙”）。根据响应代码 486，Lync Server 的出站路由逻辑将不会尝试查找新网关以完成呼叫。
但是对于 Lync Server，应将 SIP 响应代码 486 映射为 SIP 响应代码 503。响应代码 503 会触发 Lync Server 的出站路由逻辑中的重试机制；这意味着系统将尝试查找其他网关以完成呼叫。要处理这种情况，可以创建转换规则，将 ISUP 原因代码 34 和 SIP 响应代码 486 的组合映射为 SIP 响应代码 503。
Remove-CsSipResponseCodeTranslationRule 提供了一种用于删除先前配置为在组织中使用的任意转换规则的方法。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Remove-CsSipResponseCodeTranslationRule cmdlet：RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsSipResponseCodeTranslationRule"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
必需 |
Xds 标识 |
要删除的转换规则的唯一标识符。转换规则的标识由两部分组成：配置该规则的作用域，以及创建该规则时为其提供的名称。例如，对于在 global 作用域创建的名为 Rule404 的转换规则，其 Identity 如下所示：global/Rule404。 |
Force |
可选 |
开关参数 |
禁止显示运行此命令时可能出现的任何非严重错误消息。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况（无需实际执行命令）。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
Microsoft.Rtc.Management.WritableConfig.Settings.TrunkConfiguration.SipResponseCodeTranslationRule#Decorated 对象。Remove-CsSipResponseCodeTranslationRule 接受通过管道传递的 SIP 响应代码转换规则对象的实例。
返回类型
Remove-CsSipResponseCodeTranslationRule 不会返回任何对象或值。此 cmdlet 会删除 Microsoft.Rtc.Management.WritableConfig.Settings.TrunkConfiguration.SipResponseCodeTranslationRule#Decorated 对象的实例。
示例
-------------------------- 示例 1 --------------------------
Remove-CsSipResponseCodeTranslationRule -Identity "PstnGateway:192.168.0.240/Rule404"
示例 1 中显示的命令删除单个响应代码转换规则：Identity 为 PstnGateway:192.168.0.240/Rule404 的规则。
-------------------------- 示例 2 --------------------------
Get-CsSipResponseCodeTranslationRule -Filter "service:PstnGateway:192.168.0.240/*" | Remove-CsSipResponseTranslationCode
在示例 2 中，删除 PSTN 网关 192.168.0.240 中的所有响应代码转换规则。为执行此操作，该命令首先调用带有 Filter 参数的 Get-CsSipResponseCodeTranslationRule，筛选器值“service:PstnGateway:192.168.0.240/*”将返回数据限制为 Identity 以字符串值“service:PstnGateway:192.168.0.240/”开头的规则。然后，将筛选出的集合通过管道传递到 Remove-CsSipResponseTranslationCode，后者将删除集合中的每一个规则。
-------------------------- 示例 3 --------------------------
Get-CsSipResponseCodeTranslationRule | Where-Object {$_.ReceivedISUPCauseValue -eq -1} | Remove-CsSipResponseTranslationCode
上述命令删除所有尚未配置 ReceivedISUPCauseValue 属性值的响应代码转换规则。为执行此操作，该命令首先调用不带任何参数的 Get-CsSipResponseCodeTranslationRule，以返回当前正在使用的所有响应代码转换规则的集合。然后将该集合通过管道传递到 Where-Object cmdlet，后者将仅选取 ReceivedISUPCauseValue 属性等于 -1 的规则。
接下来，将筛选出的集合通过管道传递到 Remove-CsSipResponseTranslationCode，后者将删除集合中的每一个规则。