Set-CsNetworkInterRegionRoute
上次修改主題的時間： 2012-03-27
修改通話許可控制 (CAC) 組態中連線網路區域的現有路由。
語法
Set-CsNetworkInterRegionRoute [-Identity <XdsGlobalRelativeIdentity>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-NetworkRegionID1 <String>] [-NetworkRegionID2 <String>] [-NetworkRegionLinkIDs <String>] [-NetworkRegionLinks <PSListModifier>] [-WhatIf [<SwitchParameter>]]
Set-CsNetworkInterRegionRoute [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-NetworkRegionID1 <String>] [-NetworkRegionID2 <String>] [-NetworkRegionLinkIDs <String>] [-NetworkRegionLinks <PSListModifier>] [-WhatIf [<SwitchParameter>]]
詳細描述
CAC 組態中的每個區域都必須有存取其他每個區域的特定方法。地區連結會設定地區間連線的頻寬限制，也代表實體連結，而路由會決定從甲地連線到乙地時要採取的連結路徑。此指令程式會修改該路由關聯。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Set-CsNetworkInterRegionRoute Cmdlet：RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsNetworkInterRegionRoute"}
參數
| 參數 | 必要 | 類型 | 說明 |
|---|---|---|---|
Identity |
選用 |
Xds 通用相對識別 |
您要修改之網路區域路由的唯一識別碼。網路區域路由只會在全域範圍建立，因此，這個識別碼不需要指定範圍。但是，它包含識別該路由之唯一名稱的字串。 |
Instance |
選用 |
內部網路區域路由類型 |
現有區域路由的物件參考。這個物件必須屬於 Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.InterNetworkRegionRouteType 類型 (可藉由呼叫 Get-CsNetworkInterRegionRoute 指令程式擷取)。 |
NetworkRegionID1 |
選用 |
字串 |
透過此路由連線的兩個區域中，其中一個區域的 Identity (NetworkRegionID)。傳遞到此參數的值必須與 NetworkRegionID2 參數的值是不同的區域 (也就是說，您無法將區域路由傳送至本身)。此外，NetworkRegionID1 和 NetworkRegionID2 的組合必須是唯一的 (例如，您無法定義連接 NorthAmerica 和 EMEA 的兩個路由)。 |
NetworkRegionID2 |
選用 |
字串 |
透過此路由連線的兩個區域中，其中一個區域的 Identity (NetworkRegionID)。傳遞到此參數的值必須與 NetworkRegionID1 參數的值是不同的區域 (也就是說，您無法將區域路由傳送至本身)。此外，NetworkRegionID1 和 NetworkRegionID2 的組合必須是唯一的 (例如，您無法定義連接 NorthAmerica 和 EMEA 的兩個路由)。 |
NetworkRegionLinkIDs |
選用 |
字串 |
可讓您將此路由的所有連結指定為逗號分隔值的字串。這些值是區域連結的 Identity (NetworkRegionLinkIDs)。如果您同時輸入 NetworkRegionLinkIDs 與 NetworkRegionLinks 的值，將忽略 NetworkRegionLinkIDs。使用此參數修改的任何連結都會取代路由中的所有現有連結。 |
NetworkRegionLinks |
選用 |
PS 清單修飾詞 |
包含套用到此路由之區域連結 Identity (NetworkRegionLinkIDs) 的清單物件。對於此指令程式，這個參數與 NetworkRegionLinkIDs 不同之處為除了可讓您取代此路由的所有現有連結外，還可以新增或移除個別連結。 |
Force |
選用 |
切換參數 |
隱藏任何會在進行變更之前顯示的確認提示。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果，但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.InterNetworkRegionRouteType 物件。接受管線傳送的網路區間路由物件輸入。
傳回類型
這個指令程式不會傳回值。它會修改 Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.InterNetworkRegionRouteType 類型的物件。
範例
-------------------------- 範例 1 --------------------------
Set-CsNetworkInterRegionRoute -Identity NA_APAC_Route -NetworkRegionLinkIDs "NA_SA,SA_APAC"
此範例會透過變更將周遊路由的區域連結來修改路由 NA_APAC_Route。NetworkRegionLinkIDs 參數會搭配值 “NA_SA,SA_APAC” 使用，以該字串中指定的兩個連結來取代任何現有的連結。
-------------------------- 範例 2 --------------------------
Set-CsNetworkInterRegionRoute -Identity NA_APAC_Route -NetworkRegionLinks @{add="SA_EMEA"}
與範例 1 類似，範例 2 會修改 NA_APAC_Route 路由中的連結。不過，在此範例中不是使用 NetworkRegionLinkIDs 參數來取代該路由的所有連結，而是使用 NetworkRegionLinks 參數將連結新增至該路由中已存在的連結清單。在此例中，SA_EMEA 連結會新增至該路由。語法 @{add=<link>} 會將一個元素新增至連結清單。您也可以使用語法 @{replace=<link>}，以 <link> 指定的連結取代所有現有的連結 (基本上與使用 NetworkRegionLinkIDs 的行為相同)，或是使用語法 @{remove=<link>} 從清單中移除連結。
-------------------------- 範例 3 --------------------------
Set-CsNetworkInterRegionRoute -Identity NA_Route5 -NetworkRegionID2 SouthAmerica -NetworkRegionLinkIDs "NA_SA,SA_APAC"
範例 3 會修改名稱為 NA_Route5 的路由。此範例會變更組成此路由的其中一個區域。NetworkRegionID2 參數是用來指定新區域，而 NetworkRegionLinkIDs 參數則是用來建立新的連結清單以連接此路由的區域。