New-CsNetworkBWPolicy
Última modificación del tema: 2012-03-25
Crea una directiva de ancho de banda en la memoria que se puede aplicar al perfil de directiva de ancho de banda. En Microsoft Lync Server 2010, la directiva se aplica al ancho de banda de audio y vídeo.
Sintaxis
New-CsNetworkBWPolicy -BWLimit <UInt32> -BWPolicyModality <Audio | Video> -BWSessionLimit <UInt32>
Descripción detallada
Este cmdlet crea una directiva de ancho de banda. Las directivas de ancho de banda se usan para definir las limitaciones de ancho de banda de determinadas modalidades. (En Lync Server 2010, solo se pueden asignar limitaciones de ancho de banda a las modalidades de audio y vídeo.) La directiva de ancho de banda se crea únicamente en la memoria, de modo que el resultado debe asignarse a una variable y, a continuación, enviarse como valor al parámetro BWPolicy del cmdlet New-CsNetworkBandwidthPolicyProfile o Set-CsNetworkBandwidthPolicyProfile. Las directivas de ancho de banda se aplican a los perfiles de directiva, que pueden almacenar varias directivas para un solo perfil y forman parte de la configuración de red global para el control de admisión de llamadas (CAC).
Tenga en cuenta que se recomienda asignar directivas de audio y vídeo directamente a un perfil de directiva de ancho de banda llamando al cmdlet New-CsNetworkBandwidthPolicyProfile o Set-CsNetworkBandwidthPolicyProfile y especificando valores para los parámetros AudioBWLimit, AudioBWSessionLimit, VideoBWLimit y VideoBWSessionLimit.
Quién puede ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar el cmdlet New-CsNetworkBWPolicy de forma local: RTCUniversalServerAdmins. Para devolver una lista de todos los roles de control de acceso basado en roles (RBAC) a los que se ha asignado este cmdlet (incluido cualquier otro rol RBAC personalizado que usted mismo haya creado), ejecute el siguiente comando desde Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsNetworkBWPolicy"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
BWLimit |
Requerido |
UInt32 |
La cantidad máxima total de ancho de banda, en kbps, para todas las sesiones simultáneas del tipo especificado en el parámetro BWPolicyModality. |
BWPolicyModality |
Requerido |
BWPolicyModality |
Determina el tipo de ancho de banda que está limitado. Valores válidos: Audio, Video |
BWSessionLimit |
Requerido |
UInt32 |
La cantidad máxima total de ancho de banda, en kbps, permitida para una sola sesión del tipo especificado en el parámetro BWPolicyModality. |
Tipos de entrada
Ninguno.
Tipos de valores devueltos
Crea un objeto de tipo Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.BWPolicyType.
Ejemplo
-------------------------- Ejemplo 1 --------------------------
$bwp = New-CsNetworkBWPolicy -BWLimit 200 -BWSessionLimit 3000 -BWPolicyModality video
En este ejemplo se crea una directiva de ancho de banda y se asigna a la variable $bwp. Todos los parámetros del cmdlet New-CsNetworkBWPolicy son obligatorios. En este ejemplo, hemos especificado una cantidad límite total de ancho de banda (BWLimit) de 2000 kbps y un límite de sesión de ancho de banda (BWSessionLimit) de 300 kbps, y hemos aplicado estos límites a las sesiones de vídeo (-BWPolicyModality video).
-------------------------- Ejemplo 2 --------------------------
$bwp = New-CsNetworkBWPolicy -BWLimit 200 -BWSessionLimit 3000 -BWPolicyModality video
New-CsNetworkBandwidthPolicyProfile -Identity LowBWLimit -BWPolicy $bwp
El Ejemplo 2 amplía el Ejemplo 1 asignando la nueva directiva de ancho de banda a un perfil de directiva. El comando de la línea 1 es idéntico al Ejemplo 1: crea limitaciones de ancho de banda de vídeo. En la línea 2 se llama a New-CsNetworkBandwidthPolicyProfile para agregar la directiva a un perfil nuevo. El nuevo perfil recibe una identidad de LowBWLimit. A continuación, se usa el parámetro BWPolicy, con el valor $bwp, que es la variable que contiene la nueva directiva de ancho de banda que acabamos de crear en la línea 1.