Get-CsOutboundTranslationRule
上一次修改主题: 2012-03-23
检索一个或多个出站转换规则。出站转换规则将电话号码转换为本地拨号格式,以便与专用交换机 (PBX) 系统和公用电话交换网 (PSTN) 网关交互。
语法
Get-CsOutboundTranslationRule [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]
Get-CsOutboundTranslationRule [-Filter <String>] [-LocalStore <SwitchParameter>]
详细说明
调用此 cmdlet 可检索现有出站转换规则。Microsoft Lync Server 2010 将电话号码规范化为 E.164 格式。但是,许多专用交换机 (PBX) 系统无法使用此格式。在将电话号码发送到中介服务器或网关之前,出站转换规则将该号码转换为本地拨号格式。
每个出站转换规则都与一种中继配置关联。每种中继配置可关联有多个出站转换规则。因此,每个规则的标识都包含一个作用域以及一个在该作用域唯一的名称(格式为“作用域/名称”,例如 site:Redmond/OBR1)。该规则自动与同一作用域中的中继配置关联。
谁能运行此 cmdlet:默认情况下,以下各组的成员有权在本地运行 Get-CsOutboundTranslationRule cmdlet:RTCUniversalUserAdmins、RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表(包括您自己创建的任何自定义 RBAC 角色),请从 Windows PowerShell 提示符处运行以下命令:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsOutboundTranslationRule"}
参数
参数 | 必需 | 类型 | 描述 |
---|---|---|---|
Identity |
可选 |
Xds 标识 |
要检索的出站转换规则的唯一标识符。Identity 由作用域后跟各作用域中的唯一名称组成(例如,site:Redmond/OutboundRule1)。指定 Identity 的值将最多返回一个出站转换规则。 |
Filter |
可选 |
字符串 |
对 Identity 执行通配符搜索,以便将搜索结果范围缩小为仅包含标识与给定通配符字符串匹配的出站转换规则。 |
LocalStore |
可选 |
开关参数 |
从中央管理存储的本地副本,而非中央管理存储本身检索出站转换规则。 |
输入类型
无。
返回类型
此 cmdlet 检索一个或多个类型为 Microsoft.Rtc.Management.WritableConfig.Settings.TrunkConfiguration.TranslationRule 的对象。
示例
-------------------------- 示例 1 --------------------------
Get-CsOutboundTranslationRule
此示例检索 Lync Server 2010 部署的所有出站转换规则。
-------------------------- 示例 2 --------------------------
Get-CsOutboundTranslationRule -Identity "site:Redmond/Prefix Redmond"
此示例检索一个出站转换规则:Identity 为 site:Redmond/Prefix Redmond 的规则。
-------------------------- 示例 3 --------------------------
Get-CsOutboundTranslationRule -Filter site:*
此示例检索所有站点级别的出站转换规则。此命令调用筛选器为 site:* 的 Get-CsOutboundTranslationRule,这将返回 Identity 值以字符串 site: 开头的所有规则的集合。