New-CsNetworkRegionLink
上次修改主題的時間： 2012-03-25
建立針對通話許可控制 (CAC) 設定之兩個區域間的連結。
語法
New-CsNetworkRegionLink -Identity <XdsGlobalRelativeIdentity> -NetworkRegionID1 <String> -NetworkRegionID2 <String> [-BWPolicyProfileID <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
New-CsNetworkRegionLink -NetworkRegionID1 <String> -NetworkRegionID2 <String> -NetworkRegionLinkID <String> [-BWPolicyProfileID <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
詳細描述
網路中的區域是透過實體 WAN 連線相互連結。此指令程式會定義兩個區域之間的連結，並設定這些區域之間音訊和視訊連線的頻寬限制。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 New-CsNetworkRegionLink Cmdlet：RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsNetworkRegionLink"}
參數
| 參數 | 必要 | 類型 | 說明 |
|---|---|---|---|
Identity |
必要 |
Xds 通用相對識別碼 |
新建立之網路區域連結的唯一識別碼。網路區域連結只會在全域範圍建立，因此，這個識別碼不需要指定範圍。但是，它包含識別該連結之唯一名稱的字串。 |
NetworkRegionID1 |
必要 |
字串 |
連結至由 NetworkRegionID2 參數識別之區域的 Identity (NetworkRegionID)。 |
NetworkRegionID2 |
必要 |
字串 |
連結至由 NetworkRegionID1 參數識別之區域的 Identity (NetworkRegionID)。 |
NetworkRegionLinkID |
必要 |
字串 |
此值與 Identity 相同。您無法同時指定 Identity 和 NetworkRegionLinkID；針對其中一個輸入的值將會自動用於兩者。 |
BWPolicyProfileID |
選用 |
字串 |
將定義此連結頻寬限制之頻寬原則設定檔的 Identity。您可以呼叫 Get-CsNetworkBandwidthPolicyProfile 指令程式，來擷取可用的設定檔清單。 |
Force |
選用 |
切換參數 |
抑制在進行變更前可能顯示的任何確認提示。 |
InMemory |
選用 |
切換參數 |
建立物件參照，但而不實際將物件認可為永久變更。若將此參數所呼叫的 Cmdlet 輸出指派給變數，將可變更物件參照的屬性，然後呼叫此 Cmdlet 的對應 Set- Cmdlet 認可這些變更。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果，但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
無。
傳回類型
此指令程式會建立 Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.NetworkRegionLinkType 類型的物件。
範例
-------------------------- 範例 1 --------------------------
New-CsNetworkRegionLink -Identity NA_EMEA -NetworkRegionID1 NorthAmerica -NetworkRegionID2 EMEA -BWPolicyProfileID LowBWLimits
此範例會建立名稱為 NA_EMEA 的新網路區域連結以連結 NorthAmerica 和 EMEA 區域。此區域連結名稱會指定為 Identity 參數的值 (這將會自動被指派為 NetworkRegionLinkID 的值)。要連結的兩個網路區域是建立連結的必要參數，在此例中，區域名稱為 NorthAmerica 和 EMEA。在此範例中，我們也為 BWPolicyProfile 參數指派了值。這樣會將在該頻寬原則設定檔 (LowBWLimits) 中定義的頻寬限制指派給這些區域間的連線。如果未提供 BWPolicyProfileI，則這兩個區域之間的連線就沒有頻寬限制 (站台之間仍然會有限制。如需詳細資料，請參閱 New-CsNetworkSite 說明主題)。