New-CsStaticRoute
上次修改主題的時間： 2012-03-26
建立新的靜態電話路由。
語法
New-CsStaticRoute -Destination <String> -MatchUri <String> -Port <UInt16> -TLSRoute <SwitchParameter> [-Enabled <$true | $false>] [-MatchOnlyPhoneUri <$true | $false>] [-ReplaceHostInRequestUri <$true | $false>] [-TLSCertIssuer <String>] [-TLSCertSerialNumber <Byte[]>] [-UseDefaultCertificate <$true | $false>]
New-CsStaticRoute -Destination <String> -MatchUri <String> -Port <UInt16> -TCPRoute <SwitchParameter> [-Enabled <$true | $false>] [-MatchOnlyPhoneUri <$true | $false>] [-ReplaceHostInRequestUri <$true | $false>]
詳細描述
當您傳送 SIP 訊息給某人，該訊息可能需要在傳遞之前周遊多個子網路和網路；訊息所經歷的路徑通常稱為路由。在網路中，有兩種路由類型：動態及靜態。透過動態路由，伺服器使用演算法判斷訊息應轉送的下一個位置 (下一個躍點)。使用靜態路由時，訊息路徑是由系統管理員預先決定的。當伺服器收到訊息時，該伺服器會檢查訊息位址，然後將該訊息轉送到系統管理員預先設定的下一個躍點伺服器。如果設定正確，靜態路由有助於確保訊息即時且準確送達，而且可將伺服器竊聽減到最少。靜態路由的缺點是在網路故障時，無法動態地重新路由傳送訊息。
新的靜態路由是使用 New-CsStaticRoute 指令程式建立的。使用 New-CsStaticRoute 建立路由之後，您接著必須使用 Set-CsStaticRoutingConfiguration 指令程式將路由新增至路由組態設定集合。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 New-CsStaticRoute Cmdlet：RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsStaticRoute"}
參數
| 參數 | 必要 | 類型 | 說明 |
|---|---|---|---|
Destination |
必要 |
字串 |
如果路由使用傳輸層安全性 (TLS) 作為傳輸通訊協定，則 Destination 即為下一個躍點伺服器的完整網域名稱 (FQDN)。例如：-Destination "atl-proxy-001.litwareinc.com"。 如果路由使用傳輸控制通訊協定 (TCP) 作為傳輸通訊協定，則 Destination 即為下一個躍點路由器的 IP 位址。例如：-Destination "192.168.0.240"。 |
MatchUri |
必要 |
字串 |
FQDN 或網域尾碼，用來決定訊息是否傳送至此路由所處理的使用者。例如，您可以使用 FQDN "litwareinc.com"。此模式會比對具有結尾為網域名稱 "litwareinc.com" 之 SIP 位址的任何使用者。 若要比對網域的子網域，您可以使用萬用字元值，例如 "*.litwareinc.com"。該值會比對結尾尾碼為 "litwareinc.com" 的所有網域。例如：northamerica.litwareinc.com; asia.litwareinc.com; and europe.litwareinc.com。 |
Enabled |
選用 |
布林值 |
如果設為 True，則會啟用路由，而符合 MatchURI 模式的所有訊息將會路由至下一個躍點伺服器。如果設為 False，則會停用路由，而且將不會在路由訊息時使用。預設值為 True。 |
MatchOnlyPhoneUri |
選用 |
布林值 |
如果設為 True，只會比對位址設定為電話統一資源識別項 (URI) (例如 sip:kenmmyer@litwareinc.com;user=phone) 的訊息，而且可能會路由。如果設為 False (預設值)，則會比對所有訊息。 |
Port |
必要 |
整數 |
SIP 路由使用的連接埠號碼。例如：-Port 7742。 |
ReplaceHostInRequestUri |
選用 |
布林值 |
如果設為 True ($True)，則要求 URI 的主機部分將會以下一個躍點伺服器的位址取代。如果設為 False，則會使用原本的要求 URI。要求 URI 表示要求 (訊息) 已設定位址要傳送到的使用者或服務的 URI。預設值為 False。 |
TCPRoute |
選用 |
切換參數 |
設定 TCP 作為新路由的傳輸通訊協定。 |
TLSCertIssuer |
選用 |
字串 |
發行靜態路由中使用之憑證的憑證授權單位 (CA) 名稱。如果您已經設定 TCP 做為傳輸通訊協定，則不會使用此參數。 如果加入 TLSCertIssuer 參數，則也必須使用 TLSCertSerialNumber 參數。 |
TLSCertSerialNumber |
選用 |
位元組陣列 |
靜態路由中要使用之 TLS 憑證的序號。序號必須以位元組陣列的方式傳遞；也就是說，您必須以雙字元值的陣列來傳遞序號。例如：-TLSCertSerialNumber 0x01, 0xA4, 0xD5, 0x67, 0x89。 如果您已經設定 TCP 做為傳輸通訊協定，則不會使用此參數。 如果加入 TLSCertSerialNumber 參數，則也必須使用 TLSCertIssuer 參數。 |
TLSRoute |
選用 |
切換參數 |
設定 TLS 作為新路由的傳輸通訊協定。 |
UseDefaultCertificate |
選用 |
布林值 |
設定路由使用您的預設 Lync Server 2010 憑證作為其驗證憑證。如果不想使用預設憑證，則必須使用 TLSCertIssuer 和 TLSCertSerialNumber 參數指定不同的憑證。 若要檢視預設憑證，請使用以下命令： Get-CsCertificate | Where-Object {$_.Use –eq "urn:certref:Default"} |
輸入類型
無。New-CsStaticRoute 不接受管線傳送的輸入。
傳回類型
New-CsStaticRoute 會建立 Microsoft.Rtc.Management.WritableConfig.Settings.SipProxy.Route 物件的新執行個體。
範例
-------------------------- 範例 1 ------------------------
$x = New-CsStaticRoute -TCPRoute -Destination "192.168.0.100" -Port 8025 -MatchUri "litwareinc.com"
Set-CsStaticRoutingConfiguration -Identity global -Route @{Add=$x}
範例 1 所示的命令會建立新的靜態路由，然後將該路由新增至通用靜態路由組態集合。若要執行此工作，第一個命令會使用 New-CsStaticRoute 建立僅在記憶體中的路由，此路由會使用 TCP 做為其傳輸通訊協定。該路由會指向下一個躍點 IP 位址 192.168.0.100、使用連接埠 8025，然後比對來自網域 litwareinc.com 的所有 URI。所產生的路由物件會以名稱為 $x 的變數儲存。
然後，範例中的第二個命令會將新路由新增至通用靜態路由組態集合。這可以透過呼叫 Set-CsStaticRoutingConfiguration 搭配 Route 參數來完成。參數值 @{Add=$x} 會將以 $x 儲存的路由物件新增至已經在通用集合中的現有路由集。
-------------------------- 範例 2 ------------------------
$x = New-CsStaticRoute -TLSRoute -Destination "atl-proxy-001.litwareinc.com" -Port 8025 -MatchUri "*.litwareinc.com" -UseDefaultCertificate $True
Set-CsStaticRoutingConfiguration -Identity global -Route @{Add=$x}
範例 2 會示範如何建立使用 TLS 做為其傳輸通訊協定的新靜態路由，然後將該路由新增至通用靜態路由組態集合。若要這樣做，範例中的第一個命令會使用 New-CsStaticRoute 建立僅在記憶體中的路由，此路由會使用 TLS 作為其傳輸通訊協定。該路由指向 "atl-proxy-001.litwareinc.com" 作為目的地、使用連接埠 8025，且會比對任何使用網域尾碼 "litwareinc.com" 的 URI。此外，以名稱為 $x 之變數儲存的新路由物件會使用預設的憑證做為驗證之用 (-UseDefaultCertificate $True)。
已建立路由物件之後，接著範例中的第二個命令會將新路由新增至通用靜態路由組態集合。