Remove-CsOutboundTranslationRule
上一次修改主题： 2012-03-25
删除现有出站转换规则。出站转换规则使用专用交换机 (PBX) 系统将电话号码转换成本地拨号格式进行交互。
语法
Remove-CsOutboundTranslationRule -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
详细说明
调用此 cmdlet，以删除现有的出站转换规则。Microsoft Lync Server 2010 将电话号码规范化为 E.164 格式。然而，很多专用交换机 (PBX) 系统不兼容此格式。在将电话号码发送到中介服务器或网关之前，出站转换规则将该号码转换为本地拨号格式。
每个出站转换规则都与中继配置相关联。这意味着使用此 cmdlet 删除规则时，将会把规则从对应作用域的中继配置中删除。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Remove-CsOutboundTranslationRule cmdlet：RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsOutboundTranslationRule"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
必需 |
Xds 标识 |
要删除的出站转换规则的唯一标识符。Identity 由作用域后跟每个作用域中的唯一名称组成。例如，site:Redmond/OutboundRule1。 |
Force |
可选 |
开关参数 |
禁止显示任何本该在进行更改前显示的确认提示。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况（无需实际执行命令）。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
Microsoft.Rtc.Management.WritableConfig.Settings.TrunkConfiguration.TranslationRule 对象。接受通过管道传递的出站转换规则对象的输入。
返回类型
此 cmdlet 不返回值。它可删除一个类型为 Microsoft.Rtc.Management.WritableConfig.Settings.TrunkConfiguration.TranslationRule 的对象。
示例
-------------------------- 示例 1 --------------------------
Remove-CsOutboundTranslationRule -Identity "site:Redmond/Prefix Redmond"
此示例删除站点 Redmond 的现有出站转换规则（名为 Prefix Redmond）。标识是唯一的，因此此命令将删除单个规则。
-------------------------- 示例 2 --------------------------
Get-CsOutboundTranslationRule -Filter site:* | Remove-CsOutboundTranslationRule
此示例删除所有站点级别的出站转换规则。命令的第一部分是使用值为 site:* 的 Filter 调用 Get-CsOutboundTranslationRule，这将返回 Identity 值以 site: 开头的所有规则的集合。然后将筛选出的集合通过管道传递到 Remove-CsOutboundTranslationRule，后者会删除集合中的每个规则。