Compartir a través de

  • Artículo

Remove-CsNetworkBandwidthPolicyProfile

 

Última modificación del tema: 2012-03-26

Quita un perfil de directiva del ancho de banda de red.

Sintaxis

Remove-CsNetworkBandwidthPolicyProfile -Identity <XdsGlobalRelativeIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Descripción detallada

Como parte del control de admisión de llamadas (CAC), se usa una directiva de ancho de banda para definir las limitaciones de ancho de banda para ciertas modalidades. (En Microsoft Lync Server 2010, solo se pueden asignar limitaciones de ancho de banda a las modalidades de audio y vídeo). El cmdlet quita el perfil contenedor de estas directivas.

IMPORTANTE: Si se ha asignado un perfil a un sitio (mediante el cmdlet New-CsNetworkSite o Set-CsNetworkSite), a una directiva entre sitios (mediante el cmdlet New-CsNetworkInterSitePolicy o Set-CsNetworkInterSitePolicy), o a un vínculo de región de red (mediante el cmdlet New-CsNetworkRegionLink o Set-CsNetworkRegionLink) no se podrá quitar. Usted recibirá un mensaje de error si intenta quitar el perfil al llamar a Remove-CsNetworkBandwidthPolicyProfile. Primero debe quitar el perfil de todos los sitios, directivas entre sitios y vínculos de región de red y, a continuación, podrá quitar el perfil.

Quiénes pueden ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos tienen autorización para ejecutar el cmdlet Remove-CsNetworkBandwidthPolicyProfile localmente: RTCUniversalServerAdmins. Para obtener una lista de todos los roles de control de acceso basado en roles (RBAC) que se han asignado a este cmdlet (incluidos los roles personalizados RBAC que haya creado usted), ejecute el siguiente comando en el aviso de Windows PowerShell:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsNetworkBandwidthPolicyProfile"}

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Requerido

XdsGlobalRelativeIdentity

Valor de cadena que identifica de manera única el perfil de directivas de ancho de banda que desea quitar. Si especifica una identidad quitará, como mucho, un perfil.

Force

Opcional

Parámetro modificador

Suprime las solicitudes de confirmación que, de lo contrario, se mostrarían antes de realizar cambios.

WhatIf

Opcional

Parámetro modificador

Describe lo que ocurriría si se ejecutara el comando sin ejecutarlo realmente.

Confirm

Opcional

Parámetro modificador

Solicita confirmación antes de ejecutar el comando.

Tipos de entrada

Objeto Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.BWPolicyProfileType. Acepta entradas canalizadas de objetos de perfil de directiva de ancho de banda de red.

Tipos de valores devueltos

Este cmdlet no devuelve un valor. Quita un objeto de tipo Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.BWPolicyProfileType.

Ejemplo

-------------------------- Ejemplo 1 --------------------------

Remove-CsNetworkBandwidthPolicyProfile -Identity LowBWProfile

En este ejemplo, se quita el perfil de directivas de ancho de banda con la identidad LowBWProfile. Debido a que las identidades deben ser únicas quitará, como mucho, un perfil.

-------------------------- Ejemplo 2 --------------------------

Get-CsNetworkSite | Where-Object {$_.BWPolicyProfileID -eq "LowBWProfile"} | Set-CsNetworkSite -BWPolicyProfileID $null
Remove-CsNetworkBandwidthPolicyProfile -Identity LowBWProfile

En el ejemplo 2 se quitan todas las referencias al perfil de directivas de ancho de banda con la identidad LowBWProfile de todos los sitios al que ha sido asignado y, a continuación, quita ese perfil. La primera línea de este ejemplo comienza con una llamada a Get-CsNetworkSite para recuperar todos los sitios configurados para el control de admisión (CAC). Esta recopilación de sitios después se canaliza a Where-Object, el cual busca solo aquellos sitios con BWPolicyProfileID igual a (-eq) LowBWProfile. Esta recopilación reducida, que solo contiene sitios con un valor BWPolicyProfileID de LowBWProfile, se transfiere a Set-CSNetworkSite, que modifica cada uno de estos sitios para cambiar BWPolicyProfileID a nulo ($null). Lo que acabamos de hacer es encontrar todos los sitios con BWPolicyProfileID de LowBWProfile y configurar ese valor en nulo. En este punto no hay sitios que usan el perfil LowBWProfile. Ahora llamamos a Remove-CsNetworkBandwidthPolicyProfile en el perfil LowBWProfile para eliminar el perfil, sabiendo que el perfil no está en uso por parte de ningún sitio.

Para garantizar que el perfil no está en uso en ninguna ubicación de la configuración de red, realice los mismos procedimientos en la Línea 1 según directivas entre sitios y vínculos de región de red.