Remove-CsNetworkBandwidthPolicyProfile
上一次修改主题： 2012-03-26
删除网络带宽策略配置文件。
语法
Remove-CsNetworkBandwidthPolicyProfile -Identity <XdsGlobalRelativeIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
详细说明
作为呼叫允许控制 (CAC) 的一部分，使用带宽策略可定义某些形式的带宽限制。（在 Microsoft Lync Server 2010 中，只能为音频和视频形式指定带宽限制。）此 cmdlet 会删除这些策略的容器配置文件。
重要说明：如果配置文件已分配给站点（使用 New-CsNetworkSite 或 Set-CsNetworkSite cmdlet）、站点间策略（使用 New-CsNetworkInterSitePolicy 或 Set-CsNetworkInterSitePolicy cmdlet）或者网络区域链接（使用 New-CsNetworkRegionLink 或 Set-CsNetworkRegionLink cmdlet），则无法将其删除。如果尝试通过调用 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 对象。接受通过管道传递的网络带宽策略配置文件对象的输入。
返回类型
此 cmdlet 不返回值。它可删除一个类型为 Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.BWPolicyProfileType 的对象。
示例
-------------------------- 示例 1 --------------------------
Remove-CsNetworkBandwidthPolicyProfile -Identity LowBWProfile
此示例将删除 Identity 为 LowBWProfile 的带宽策略配置文件。因为标识必须是唯一的，这将最多删除一个配置文件。
-------------------------- 示例 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)。这样，就完成了查找 BWPolicyProfileID 为 LowBWProfile 的所有站点，并且将该值设置为 Null 的过程。此时就不存在使用 LowBWProfile 配置文件的站点。现在，对配置文件 LowBWProfile 调用 Remove-CsNetworkBandwidthPolicyProfile 以删除该配置文件，因为已知晓该配置文件当前未被任何站点使用。
要确保该配置文件未用于网络配置中的任何位置，请在第 1 行中针对站点间策略和网络区域链接执行相同的步骤。