Get-CsNetworkInterRegionRoute

語法

Get-CsNetworkInterRegionRoute [-Identity <XdsGlobalRelativeIdentity>] [-LocalStore <SwitchParameter>]

Get-CsNetworkInterRegionRoute [-Filter <String>] [-LocalStore <SwitchParameter>]

詳細描述

CAC 組態中的每個區域都必須有存取其他每個區域的特定方法。地區連結會設定地區間連線的頻寬限制，也代表實體連結，而路由會決定從甲地連線到乙地時要採取的連結路徑。此指令程式會擷取這些路由關聯的相關資訊。

誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Get-CsNetworkInterRegionRoute Cmdlet：RTCUniversalUserAdmins、RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsNetworkInterRegionRoute"}

參數

輸入類型

無。

傳回類型

此指令程式會傳回 Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.InterNetworkRegionRouteType 類型的一或多個物件。

範例

-------------------------- 範例 1 --------------------------

Get-CsNetworkInterRegionRoute -Identity NA_APAC_Route

範例 1 會擷取 Identity 為 NA_APAC_Route 的路由。

-------------------------- 範例 2 --------------------------

Get-CsNetworkInterRegionRoute -Filter *APAC*

在範例 2 中，我們使用 Filter 參數來擷取 Identity 中任何位置包含字串 APAC 的所有路由。

-------------------------- 範例 3 --------------------------

Get-CsNetworkInterRegionRoute | Where-Object {$_.NetworkRegionLinks -eq "NA_EMEA"}

此範例會擷取使用網路區域連結 NA_EMEA 的所有區域路由。此命令會從呼叫 Get-CsNetworkInterRegionRoute 開始。呼叫此指令程式且不搭配任何參數，會擷取以 CAC 組態定義的所有路由。接著，此路由集合會傳送到 Where-Object 指令程式。Where-Object 會取得該集合並擷取集合的 NetworkRegionLinks 清單中擁有 NA_EMEA 值的所有項目。

-------------------------- 範例 4 --------------------------

Get-CsNetworkInterRegionRoute | Where-Object {$_.NetworkRegionID1 -eq "NorthAmerica" -or $_.NetworkRegionID2 -eq "NorthAmerica"}

範例 4 會擷取包含 NorthAmerica 區域的所有區域路由。命令的第一個部分是對 Get-CsNetworkInterRegionRoute 指令程式的呼叫。這個以不含任何參數呼叫的指令程式會擷取所有區域路由。接著，將此路由集合傳送至 Where-Object 指令程式。Where-Object 指令程式會將集合縮小到只含有定義了 NorthAmerica 作為路由途中其中一個地區的路由。作法是，檢查路由的 NetworkRegionID1 值是否等於 (-eq) NorthAmerica，或者其 (-or) NetworkRegionID2 值等於 NorthAmerica。

請參閱

其他資源

New-CsNetworkInterRegionRoute
Remove-CsNetworkInterRegionRoute
Set-CsNetworkInterRegionRoute