Get-CsBandwidthPolicyServiceConfiguration
上次修改主題的時間： 2012-03-23
擷取一或多個頻寬原則服務組態。
語法
Get-CsBandwidthPolicyServiceConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]
Get-CsBandwidthPolicyServiceConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>]
詳細描述
通話許可控制 (CAC) 是一種根據頻寬限制，判斷是否允許建立即時通訊工作階段 (例如語音或視訊通話) 的方式。在 Microsoft Lync Server 2010 的 CAC 實作中，地區、站台及子網路是在網路中與這些實體之間的關係和連結一起定義，以便對它們之間的頻寬加上限制。頻寬原則服務是在 Lync Server 2010 部署中執行 CAC 功能的元件，能判斷目前是否有足夠的頻寬可建立通話。Get-CsBandwidthPolicyServiceConfiguration 指令程式會擷取一或多個頻寬原則服務的設定。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Get-CsBandwidthPolicyServiceConfiguration Cmdlet：RTCUniversalUserAdmins、RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsBandwidthPolicyServiceConfiguration"}
參數
| 參數 | 必要 | 類型 | 說明 |
|---|---|---|---|
Identity |
選用 |
Xds 識別碼 |
您要擷取之組態的唯一識別碼。此識別碼將會包含範圍 (針對通用組態) 或範圍與名稱 (針對網站層級組態，例如 site:Redmond)。 |
Filter |
選用 |
字串 |
包含一或多個萬用字元的一個字串，用來搜尋所有頻寬原則服務組態的 Identity 屬性，以尋找 Identity 符合萬用字元模式的所有組態。例如，Filter 值 site:* 將會擷取其 Identity 值開頭字串為 site:，且結尾為任何字元集的所有組態。 |
LocalStore |
選用 |
SwitchParamter |
從中央管理存放區的本機複本擷取頻寬原則服務組態，而非從中央管理存放區本身擷取。 |
輸入類型
無。
傳回類型
傳回 Microsoft.Rtc.Management.WritableConfig.Settings.BandwidthPolicyServiceConfiguration.BandwidthPolicyServiceConfiguration 類型的一或多個物件。
範例
-------------------------- 範例 1 --------------------------
Get-CsBandwidthPolicyServiceConfiguration
範例 1 會擷取在 Microsoft Lync Server 2010 實作中定義的所有頻寬原則服務組態。
-------------------------- 範例 2 --------------------------
Get-CsBandwidthPolicyServiceConfiguration -Identity site:Redmond
此範例會擷取針對 Redmond 網站 (-Identity site:Redmond) 定義的頻寬原則服務組態。
-------------------------- 範例 3 --------------------------
Get-CsBandwidthPolicyServiceConfiguration -Filter site:*
在此範例中，我們使用 Filter 參數來擷取在網站層級定義的所有頻寬原則服務組態。我們藉由將值 site:* 傳遞到 Filter 參數來完成此作業。這將搜尋所有頻寬原則服務組態的 Identity 屬性，找出開頭為 site: 且緊接著任何其他字元的值。由於所有網站層級的組態都具備開頭為 site: 且緊接著網站名稱的 Identity 值，因此，此篩選將會尋找所有網站的所有組態。
-------------------------- 範例 4 --------------------------
Get-CsBandwidthPolicyServiceConfiguration | Where-Object {$_.MaxLogFileSizeMb -gt 4}
範例 4 會擷取允許記錄檔達到大於 4 MB 的所有頻寬原則服務組態。此範例會從呼叫 Get-CsBandwidthPolicyServiceConfiguration 指令程式開始。正如範例 1，此指令程式會擷取在 Lync Server 部署中定義之所有組態的集合。此集合會被傳送到 Where-Object 指令程式。Where-Object 會一次一個項目，循環整個集合。針對集合中的每個項目，Where-Object 會檢查 MaxLogFileSizeMb 屬性的值是否大於 (-gt) 4。如果大於 4，該項目會保留在集合的一部分，並且成為命令輸出的一部分。如果 MaxLogFileSizeMb 的值沒有大於 4，則會忽略該項目，且不會傳回。