Set-CsRoutingConfiguration
上一次修改主题: 2012-03-26
修改语音路由列表。
语法
Set-CsRoutingConfiguration [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Route <PSListModifier>] [-WhatIf [<SwitchParameter>]]
Set-CsRoutingConfiguration [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-Route <PSListModifier>] [-WhatIf [<SwitchParameter>]]
详细说明
语音路由包含一些说明,指示 Microsoft Lync Server 2010 如何将来自企业语音用户的呼叫路由到公用电话交换网 (PSTN) 或专用交换机 (PBX) 上的电话号码。使用此 cmdlet 可以修改在 Lync Server 2010 部署中定义的所有语音路由的设置。
建议不要使用此 cmdlet。要修改路由配置,请通过调用 Set-CsVoiceRoute cmdlet 来修改各个语音路由。
谁能运行此 cmdlet:默认情况下,以下各组的成员有权在本地运行 Set-CsRoutingConfiguration cmdlet:RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表(包括您自己创建的任何自定义 RBAC 角色),请从 Windows PowerShell 提示符处运行以下命令:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsRoutingConfiguration"}
参数
参数 | 必需 | 类型 | 描述 |
---|---|---|---|
Identity |
可选 |
Xds 标识 |
路由配置的作用域。此值必须为 Global。 |
Instance |
可选 |
PstnRoutingSettings |
路由配置 (Microsoft.Rtc.Management.WritablConfig.Policy.Voice.PstnRoutingSettings) 对象。此类型的对象可以通过调用 Get-CsRoutingConfiguration 进行检索。 |
Route |
可选 |
路由 |
为 Lync Server 部署定义的所有语音路由(Microsoft.Rtc.Management.WritableConfig.Policy.Voice.Route 对象)的列表。 应该使用 Set-CsVoiceRoute cmdlet 修改各个语音路由对象。建议使用此方法修改此列表中的路由。 |
Force |
可选 |
开关参数 |
在进行更改前取消可能另外显示的任何确认提示。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况(无需实际执行命令)。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
Microsoft.Rtc.WritableConfig.Management.Policy.Voice.PSTNRoutingSettings 对象。接受通过管道传递的路由配置对象的输入。
返回类型
Set-CsRoutingConfiguration 不会返回值或对象。此 cmdlet 会配置 Microsoft.Rtc.Management.WritableConfig.Policy.Voice.PstnRoutingSettings 对象的实例。
示例
-------------------------- 示例 1 --------------------------
$a = Get-CsRoutingConfiguration
$b = $a.Route | Where-Object {$_.Name -match "LocalRoute"}
$b.SuppressCallerId = $False
Set-CsRoutingConfiguration -Instance $a
修改路由配置中的语音路由需要若干步骤。在此示例中,首先通过调用 Get-CsRoutingConfiguration 检索路由配置对象。将检索到的对象(只有一个)分配给变量 $a。
在此示例的第 2 行中,从变量 $a 中检索 Route 属性的内容,它是语音路由对象的集合。然后将该集合通过管道传递到 Where-Object cmdlet,通过该 cmdlet 在集合中搜索 Name 与字符串 LocalRoute 匹配的所有语音路由对象。将该对象分配给变量 $b。
接下来,通过为 SuppressCallerId 属性分配 $False 值来修改 LocalRoute 语音路由对象。通过更新该对象,已经在变量 $a 中更新了该对象。但是,该对象仍然只保存在内存中。最后,需要将 $a 传递到 Set-CsRoutingConfiguration 的 Instance 参数来保存所做的更改。
建议不要使用该方法修改路由配置。要修改路由配置,只需使用 Set-CsVoiceRoute 属性更改各个语音路由,如下所示:
Set-CsVoiceRoute -Identity LocalRoute -SuppressCallerId $False
此行与示例 1 中完成的任务相同。