New-CsRoutingConfiguration
上次修改主題的時間: 2012-03-26
這個指令程式可以傳回包含路由設定物件之預設值的物件。
語法
New-CsRoutingConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-Route <PSListModifier>] [-WhatIf [<SwitchParameter>]]
詳細描述
路由設定是 Microsoft Lync Server 2010 部署內定義之所有語音路由的容器。若要建立新的語立路由,請使用 New-CsVoiceRoute 指令程式。
路由設定只能在通用等級進行定義。此外,您不能個別為路由設定進行命名;整個 Lync Server 2010 部署只有一份語音路由清單。在 Windows PowerShell 的 Lync Server 2010 實作中,如果嘗試呼叫以 New 動詞開始的指令程式來建立已經存在的物件,將會收到錯誤訊息。每個 Lync Server 2010 實作都包含預設的路由設定物件,其具有 Global Identity。這意味著,唯一可以建立的語音路由清單已經存在。因此,呼叫 New-CsRoutingConfiguration 一定會傳回錯誤訊息,且不會建立新的路由設定。
唯一的例外是,您在呼叫此指令程式時指定了 InMemory 參數。這個命令只會在記憶體中建立物件,其中包含語音路由的預設清單。
誰可以執行此 Cmdlet:下列群組的成員預設會獲授權可以在本機上執行 New-CsRoutingConfiguration Cmdlet:RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色),請在 Windows PowerShell 提示字元中執行下列命令:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsRoutingConfiguration"}
參數
參數 | 必要 | 類型 | 描述 |
---|---|---|---|
Identity |
必要 |
XdsIdentity |
路由組態的範圍。這個值必須是 Global。 |
Route |
選用 |
PSListModifier |
針對 Lync Server 2010 部署定義的所有語音路由清單 (Microsoft.Rtc.Management.WritableConfig.Policy.Voice.Route 物件)。 您可以使用 New-CsVoiceRoute 指令程式建立語音路由物件。這是新增語音路由到此清單的建議方式。 |
Force |
選用 |
切換參數 |
隱藏任何會在進行變更之前顯示的確認提示。 |
InMemory |
選用 |
切換參數 |
建立物件參照,但而不實際將物件認可為永久變更。若將此參數所呼叫的 Cmdlet 輸出指派給變數,將可變更物件參照的屬性,然後呼叫此 Cmdlet 的對應 Set- Cmdlet 認可這些變更。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果,但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
無。
傳回類型
可以建立 Microsoft.Rtc.Management.WritableConfig.Policy.Voice.PstnRoutingSettings 類型的記憶體內物件。
範例
-------------------------- 範例 1 --------------------------
$x = New-CsRoutingConfiguration -Identity global -InMemory
這個命令會建立包含預設路由設定值的物件,並將該物件指派給變數 $x。此指令程式的任何其他用法都會傳回錯誤。