Remove-CsNetworkBandwidthPolicyProfile
上次修改主題的時間： 2012-03-26
移除網路頻寬原則設定檔。
語法
Remove-CsNetworkBandwidthPolicyProfile -Identity <XdsGlobalRelativeIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
詳細描述
頻寬原則是通話許可控制 (CAC) 的一部分，用來定義特定形式的頻寬限制 (在 Microsoft Lync Server 2010 中，只會指派音訊與視訊形式的頻寬限制)。此指令程式會移除這些原則的容器設定檔。
重要：如果某個設定檔已指派給網站 (使用 New-CsNetworkSite 或 Set-CsNetworkSite 指令程式)、指派給站台間原則 (使用 New-CsNetworkInterSitePolicy 或 Set-CsNetworkInterSitePolicy 指令程式)，或指派給網路區域連結 (使用 New-CsNetworkRegionLink 或 Set-CsNetworkRegionLink 指令程式)，便無法移除該設定檔。如果您透過呼叫 Remove-CsNetworkBandwidthPolicyProfile 來移除該設定檔，將會收到錯誤。您必須先從所有網站、站台間原則及網路區域連結中移除該設定檔，然後才可以移除該設定檔。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Remove-CsNetworkBandwidthPolicyProfile Cmdlet：RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsNetworkBandwidthPolicyProfile"}
參數
| 參數 | 必要 | 類型 | 說明 |
|---|---|---|---|
Identity |
必要 |
Xds 通用相對識別碼 |
唯一識別您要移除之頻寬原則設定檔的字串值。指定 Identity 將會至多移除一個設定檔。 |
Force |
選用 |
切換參數 |
抑制在進行變更前可能顯示的任何確認提示。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果，但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.BWPolicyProfileType 物件。接受管線傳送的網路頻寬原則設定檔物件輸入。
傳回類型
這個指令程式不會傳回值。它會移除 Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.BWPolicyProfileType 類型的物件。
範例
-------------------------- 範例 1 --------------------------
Remove-CsNetworkBandwidthPolicyProfile -Identity LowBWProfile
此範例會移除 Identity 為 LowBWProfile 的頻寬原則設定檔。由於 Identity 必須是唯一的，因此這最多會移除一個設定檔。
-------------------------- 範例 2 --------------------------
Get-CsNetworkSite | Where-Object {$_.BWPolicyProfileID -eq "LowBWProfile"} | Set-CsNetworkSite -BWPolicyProfileID $null
Remove-CsNetworkBandwidthPolicyProfile -Identity LowBWProfile
範例 2 會從已指派 Identity 為 LowBWProfile 之頻寬原則設定檔的所有網站，移除該頻寬原則設定檔的所有參考，然後移除該設定檔。此範例的第一行是從呼叫 Get-CsNetworkSite 開始，以擷取針對通話許可控制 (CAC) 設定的所有站台。接著，這個站台集合會傳送到 Where-Object，只尋找 BWPolicyProfileID 等於 (-eq) LowBWProfile 的站台。這個縮小範圍後的集合 (只包含 BWPolicyProfileID 值為 LowBWProfile 的站台) 會傳送到 Set-CSNetworkSite，以修改其中的每個站台，將 BWPolicyProfileID 變更為 Null ($null)。我們剛才所做的就是尋找 LowBWProfile 的 BWPolicyProfileID 之所有網站，並將該值設為 Null。此時，沒有任何使用 LowBWProfile 設定檔的網站。我們現在可以在設定檔 LowBWProfile 上呼叫 Remove-CsNetworkBandwidthPolicyProfile 以移除設定檔，因為我們已經知道沒有任何站台正在使用該設定檔。
若要確保網路組態中的任何位置都未使用該設定檔，請針對站台間原則及網路區域連結執行第一行中的相同步驟。