New-CsBandwidthPolicyServiceConfiguration
上次修改主題的時間： 2012-03-23
建立新的頻寬原則服務組態。
語法
New-CsBandwidthPolicyServiceConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-EnableLogging <$true | $false>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-LogCleanUpInterval <TimeSpan>] [-MaxLogFileSizeMb <UInt32>] [-MaxTokenLifetime <TimeSpan>] [-WhatIf [<SwitchParameter>]]
詳細描述
通話許可控制 (CAC) 是一種根據頻寬限制，判斷是否允許建立即時通訊工作階段 (例如語音或視訊通話) 的方式。在 Microsoft Lync Server 2010 的 CAC 實作中，地區、網站及子網路是在網路中與這些實體之間的關係和連結一起定義，以便對它們之間的頻寬加上限制。頻寬原則服務是在 Lync Server 2010 部署中執行 CAC 功能的元件，能判斷目前是否有足夠的頻寬可建立通話。此指令程式會在網站層級設定新的頻寬原則服務。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 New-CsBandwidthPolicyServiceConfiguration Cmdlet：RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsBandwidthPolicyServiceConfiguration"}
參數
| 參數 | 必要 | 類型 | 說明 |
|---|---|---|---|
Identity |
必要 |
Xds 識別碼 |
包含組態之範圍與名稱的唯一識別碼。此組態只能在網站範圍建立，因此 Identity 的格式如下：site:<site name>，其中 <site name> 是套用組態的網站名稱。 |
EnableLogging |
選用 |
布林值 |
將此參數設為 True 可產生與頻寬原則服務相關的 CAC 失敗及連結狀態記錄檔。 預設值：False |
LogCleanUpInterval |
選用 |
時間範圍 |
CAC 失敗及連結狀態記錄檔的保留時間，超過此時間之後，將會移除記錄檔。 此值必須介於 1 天至 60 天的範圍內。此值必須以 dd.hh:mm:ss 格式輸入，其中 d 為天數、h 為小時數、m 為分鐘數、s 為秒數。 預設值：10 天 (10.00:00:00) |
MaxLogFileSizeMb |
選用 |
UInt32 |
允許記錄檔達到的大小上限。此參數的值必須是正值，用以指定檔案的大小，單位為 MB。 預設值：3 (MB) |
MaxTokenLifetime |
選用 |
時間範圍 |
寬頻原則驗證服務發出的權杖將存在的時間長度上限。 此值必須介於 1 小時至 24 小時的範圍內。此值必須以 dd.hh:mm:ss 格式輸入，其中 d 為天數、h 為小時數、m 為分鐘數、s 為秒數。 預設值：8 小時 (08:00:00) |
Force |
選用 |
切換參數 |
抑制在進行變更前可能顯示的任何確認提示。 |
InMemory |
選用 |
切換參數 |
建立物件參照，但而不實際將物件認可為永久變更。若將此參數所呼叫的 Cmdlet 輸出指派給變數，將可變更物件參照的屬性，然後呼叫此 Cmdlet 的對應 Set- Cmdlet 認可這些變更。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果，但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
無。
傳回類型
建立 Microsoft.Rtc.Management.WritableConfig.Settings.BandwidthPolicyServiceConfiguration.BandwidthPolicyServiceConfiguration 類型的物件。
範例
-------------------------- 範例 1 --------------------------
New-CsBandwidthPolicyServiceConfiguration -Identity site:Redmond
此範例會在 Redmond 網站 (-Identity site:Redmond) 建立新的頻寬原則服務組態。由於未指定其他參數，因此所有組態值皆會使用預設值。
-------------------------- 範例 2 --------------------------
New-CsBandwidthPolicyServiceConfiguration -Identity site:Dublin -EnableLogging $True -LogCleanupInterval 30.00:00:00
在此範例中，我們再次建立新的頻寬原則服務組態，但這次是針對 Dublin 網站 (-Identity site:Dublin)。針對這個網站，我們不接受預設值，而是希望啟用記錄並將記錄檔清除前的保留天數設為 30 天。我們透過傳遞 True ($True) 值給 EnableLogging 參數，然後傳遞 30.00:00:00 值給 LogCleanupInterval 參數來完成此工作。LogCleanupInterval 值是一個 TimeSpan 物件，其格式為 dd.hh:mm:ss，其中 d 為天數、h 為小時數、m 為分鐘數、s 為秒數。