New-CsStaticRoutingConfiguration
上次修改主題的時間： 2012-03-26
建立新的靜態路由組態設定集合。
語法
New-CsStaticRoutingConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-Route <PSListModifier>] [-WhatIf [<SwitchParameter>]]
詳細描述
當您傳送 SIP 訊息給某人，該訊息可能需要在傳遞之前周遊多個子網路和網路；訊息所經歷的路徑通常稱為路由。在網路中，有兩種路由類型：動態及靜態。使用動態路由時，伺服器會使用演算法來決定應該將訊息轉送到的下一個位置 (下一個躍點)。使用靜態路由時，訊息路徑是由系統管理員預先決定的。當伺服器收到訊息時，該伺服器會檢查訊息位址，然後將該訊息轉送到系統管理員預先設定的下一個躍點伺服器。如果設定正確，靜態路由有助於確保訊息即時且準確送達，而且可將伺服器竊聽減到最少。靜態路由的缺點是在網路故障時，無法動態地重新路由傳送訊息。
安裝 Microsoft Lync Server 2010 時，會自動為您建立靜態路由的通用集合。除此之外，您可以使用 New-CsStaticRoutingConfiguration 指令程式來建立其他集合以及網站範圍或服務範圍 (僅適用於登錄器服務)。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 New-CsStaticRoutingConfiguration Cmdlet：RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsStaticRoutingConfiguration"}
參數
| 參數 | 必要 | 類型 | 說明 |
|---|---|---|---|
Identity |
必要 |
Xds 識別碼 |
要建立之新靜態路由集合的唯一識別碼。新的集合只能在服務範圍建立，而且只能指派給登錄程式服務。因此，新集合的 Identity 看起來必須類似如下：-Identity "service:Registrar:atl-cs-001.litwareinc.com"。 |
Route |
選用 |
PS 清單修飾詞 |
集合中保持的個別靜態路由。要新增至集合的路由必須是從另一個集合複製而來，或是使用 New-CsStaticRoute 建立。如需詳細資料，請參閱本主題中的＜範例＞區段。 |
Force |
選用 |
切換參數 |
隱藏顯示當執行命令時可能發生的任何非嚴重錯誤訊息。 |
InMemory |
選用 |
切換參數 |
建立物件參照，但而不實際將物件認可為永久變更。若將此參數所呼叫的 Cmdlet 輸出指派給變數，將可變更物件參照的屬性，然後呼叫此 Cmdlet 的對應 Set- Cmdlet 認可這些變更。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果，但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
無。New-CsStaticRoutingConfiguration 不接受管線傳送的輸入。
傳回類型
New-CsStaticRoutingConfiguration 會建立 Microsoft.Rtc.Management.WritableConfig.Settings.SipProxy.RoutingSettings 物件的新執行個體。
範例
-------------------------- 範例 1 ------------------------
New-CsStaticRoutingConfiguration -Identity "service:Registrar:atl-cs-001.litwareinc.com"
以上的命令會建立 Identity 為 service:Registrar:atl-cs-001.litwareinc.com 的新靜態路由組態集合。因為未在命令中加入 Route 參數，因此不會將任何靜態路由指派給新集合。
-------------------------- 範例 2 ------------------------
$x = New-CsStaticRoute -TCPRoute -Destination "192.168.0.100" -Port 8025 -MatchUri "*.litwareinc.com"
New-CsStaticRoutingConfiguration -Identity "service:Registrar:atl-cs-001.litwareinc.com" -Route $x
範例 2 所示的命令會建立使用 TCP 做為其傳輸的新 SIP Proxy 路由；然後，這個新路由會新增至新的靜態路由組態集合。若要完成此動作，範例中的第一個命令會使用 New-CsStaticRoute 建立一個指向下一個躍點伺服器，且 IP 位址為 192.168.1.100 的新路由。這個新路由 (以名稱為 $x 的變數儲存) 也會使用連接埠 8025 以及 MatchUri "*.litwareinc.com"。
之後，會呼叫 New-CsStaticRoutingConfiguration 以建立新的集合 (Identity 為 service:Registrar:atl-cs-001.litwareinc.com)，並將儲存在變數 $x 中的路由指派給新集合的 Route 屬性。