Get-CsNetworkInterSitePolicy
上次修改主題的時間: 2012-03-23
擷取一或多個網路站台間原則,這些原則定義了直接在通話許可控制 (CAC) 組態中連結的站台之間的頻寬限制。
語法
Get-CsNetworkInterSitePolicy [-Identity <XdsGlobalRelativeIdentity>] [-LocalStore <SwitchParameter>]
Get-CsNetworkInterSitePolicy [-Filter <String>] [-LocalStore <SwitchParameter>]
詳細描述
當網路站台共用直接連結時,您可以定義這兩個站台之間音訊與視訊連線的頻寬限制。此指令程式會擷取一或多個網路站台原則,這些原則建立了頻寬限制設定和直接連線站台之間的關聯。
誰可以執行此 Cmdlet:下列群組的成員預設會獲授權可以在本機上執行 Get-CsNetworkInterSitePolicy Cmdlet:RTCUniversalUserAdmins、RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色),請在 Windows PowerShell 提示字元中執行下列命令:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsNetworkInterSitePolicy"}
參數
參數 | 必要 | 類型 | 描述 |
---|---|---|---|
Identity |
選用 |
XdsGlobalRelativeIdentity |
您要擷取之網路站台原則的唯一識別碼。由於網路站台原則只在全域範圍建立,因此這個識別碼不需要指定範圍,而是包含一個字串,代表該原則的唯一識別名稱。 |
Filter |
選用 |
字串 |
包含萬用字元的字串,只會搜尋 Identity 值與萬用字元字串相符的原則。 |
LocalStore |
選用 |
切換參數 |
從中央管理存放區本機複本擷取網路站台間原則資訊,而不是從中央管理存放區本身擷取。 |
輸入類型
無。
傳回類型
擷取 Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.InterNetworkSitePolicyType 類型的物件。
範例
-------------------------- 範例 1 --------------------------
Get-CsNetworkInterSitePolicy
呼叫 Get-CsNetworkInterSitePolicy 且為搭配參數,會擷取兩個直接連線的網路站台之間定義的所有網路站台原則。
-------------------------- 範例 2 --------------------------
Get-CsNetworkInterSitePolicy -Identity Reno_Portland
此範例會擷取 Identity 為 Reno_Portland 的網路站台原則。
-------------------------- 範例 3 --------------------------
Get-CsNetworkInterSitePolicy -Filter *Reno*
範例 3 會擷取在 Identity 值中出現 Reno 字串的所有網路站台原則。傳遞給 Filter 參數的值中帶有萬用字元(*),表示「任何字元或字元組」。換句話說,字串 *Reno* 將尋找的 Identity 值,是以任何字元或字元組開頭,之後跟著字串 Reno,之後再跟著任何字元或字元組。
-------------------------- 範例 4 --------------------------
Get-CsNetworkInterSitePolicy | Where-Object {$_.BWPolicyProfileID -eq $null}
此範例會擷取所有未指派頻寬原則設定檔的網路站台原則。命令首先呼叫 Get-CsNetworkInterSitePolicy,如範例 1 所示,擷取所有網路站台原則的集合。此集合會被傳送到 Where-Object 指令程式。Where-Object 將集合縮小到只包含未指派頻寬原則設定檔的站台原則。作法是,比較查看每個站台原則的 BWPolicyProfileID 屬性是否等於 (-eq) Null ($null)。