New-CsNetworkInterSitePolicy
上次修改主題的時間： 2012-03-27
建立新的網路站台間原則，該網路站台間原則定義通話許可控制 (CAC) 組態中直接相連之站台間的頻寬限制。
語法
New-CsNetworkInterSitePolicy -Identity <XdsGlobalRelativeIdentity> -NetworkSiteID1 <String> -NetworkSiteID2 <String> [-BWPolicyProfileID <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
New-CsNetworkInterSitePolicy -InterNetworkSitePolicyID <String> -NetworkSiteID1 <String> -NetworkSiteID2 <String> [-BWPolicyProfileID <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
詳細描述
當網路站台共用直接連結時，您可以定義這兩個站台之間音訊與視訊連線的頻寬限制。此指令程式可建立使頻寬限制原則和兩個直接連線之站台相關聯的網路站台原則。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 New-CsNetworkInterSitePolicy Cmdlet：RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsNetworkInterSitePolicy"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Identity |
必要 |
XdsGlobalRelativeIdentity |
新建立網路站台間原則的唯一識別碼。由於網路站台間原則只在全域範圍建立，因此這個識別碼不需要指定範圍，而是包含一個字串，代表該站台原則的唯一識別名稱。 |
InterNetworkSitePolicyID |
必要 |
字串 |
這個值與 Identity 相同。您無法指定 Identity 與 InterNetworkSitePolicyID 兩者；輸入至其中一個的值將會自動用於兩者。 |
NetworkSiteID1 |
必要 |
字串 |
與此原則相關聯之兩個站台其中一個的 Identity (NetworkSiteID)。NetworkSiteID1 與 NetworkSiteID2 的組合必須是唯一的 (例如，您無法定義兩個連接 Reno 和 Portland 的站台原則)。 |
NetworkSiteID2 |
必要 |
字串 |
與此原則相關聯之兩個站台其中一個的 Identity (NetworkSiteID)。NetworkSiteID1 與 NetworkSiteID2 的組合必須是唯一的 (例如，您無法定義兩個連接 Reno 和 Portland 的站台原則)。 |
BWPolicyProfileID |
選用 |
字串 |
頻寬原則設定檔的 Identity，此頻寬原則設定檔將定義此站台原則的限制。您可以呼叫 Get-CsNetworkBandwidthPolicyProfile 指令程式，來擷取可用的設定檔清單。 |
Force |
選用 |
切換參數 |
隱藏任何會在進行變更之前顯示的確認提示。 |
InMemory |
選用 |
切換參數 |
建立物件參照，但而不實際將物件認可為永久變更。若將此參數所呼叫的 Cmdlet 輸出指派給變數，將可變更物件參照的屬性，然後呼叫此 Cmdlet 的對應 Set- Cmdlet 認可這些變更。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果，但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
無。
傳回類型
建立 Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.InterNetworkSitePolicyType 類型的物件。
範例
-------------------------- 範例 1 --------------------------
New-CsNetworkInterSitePolicy -Identity Reno_Portland -NetworkSiteID1 Reno -NetworkSiteID2 Portland -BWPolicyProfileID LowBWLimits
這個範例會建立一個新網路站台間原則，其會限制連線站台 Reno 與 Portland 之間的頻寬。根據頻寬原則設定檔 LowBWLimits 的設定，這些站台間的音訊與視訊連線的頻寬限制是有限的。