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 如何將 Enterprise Voice 使用者的來電轉接至公用交換電話網路 (PSTN) 或專用交換機 (PBX) 上的電話號碼。使用這個指令程式,可以修改在 Lync Server 2010 部署內定義之任何語音路由的設定。
不建議使用這個指令程式。若要修改路由設定,可呼叫 Set-CsVoiceRoute 指令程式,修改個別的語音路由。
誰可以執行此 Cmdlet:下列群組的成員預設會獲授權可以在本機上執行 Set-CsRoutingConfiguration Cmdlet:RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色),請在 Windows PowerShell 提示字元中執行下列命令:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsRoutingConfiguration"}
參數
參數 | 必要 | 類型 | 描述 |
---|---|---|---|
Identity |
選用 |
XdsIdentity |
路由組態的範圍。這必須是 Global。 |
Instance |
選用 |
PstnRoutingSettings |
路由組態 (Microsoft.Rtc.Management.WritablConfig.Policy.Voice.PstnRoutingSettings) 物件。呼叫 Get-CsRoutingConfiguration 可擷取此類型的物件。 |
Route |
選用 |
路由 |
針對 Lync Server 部署定義的所有語音路由清單 (Microsoft.Rtc.Management.WritableConfig.Policy.Voice.Route 物件)。 您應該使用 Set-CsVoiceRoute 指令程式,修改個別的語音路由物件。那是修改此清單中之路由的建議方式。 |
Force |
選用 |
切換參數 |
隱藏任何會在進行變更之前顯示的確認提示。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果,但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
Microsoft.Rtc.WritableConfig.Management.Policy.Voice.PSTNRoutingSettings 物件。接受路由組態物件管線傳送的輸入。
傳回類型
Set-CsRoutingConfiguration 不會傳回值或物件。而是指令程式會設定 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 指令程式,由其搜尋 Name 與字串 LocalRoute 相符之所有語音路由物件的集合。我們將該物件指定到變數 $b。
接下來,我們為 SuppressCallerId 屬性指定 $False 值,以修改 LocalRoute 語音路由物件。更新該物件,即可更新變數 $a 中的物件。但是該物件仍然只留在記憶體中。最後一步,我們需要儲存那些變更,方法是將 $a 傳遞給 Set-CsRoutingConfiguration 的 Instance 參數。
這並不是修改路由組態的建議方式。若要修改路由組態,請使用 Set-CsVoiceRoute 屬性變更個別語音路由,如下所示:
Set-CsVoiceRoute -Identity LocalRoute -SuppressCallerId $False
這一行會完成範例 1 所示的相同工作。