New-CsNetworkBandwidthPolicyProfile
Última modificación del tema: 2012-03-24
Crea un nuevo perfil de directiva de ancho de banda para la red. Este cmdlet se puede usar también para establecer las directivas de ancho de banda del perfil.
Sintaxis
New-CsNetworkBandwidthPolicyProfile -Identity <XdsGlobalRelativeIdentity> [-AudioBWLimit <String>] [-AudioBWSessionLimit <String>] [-BWPolicy <PSListModifier>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-VideoBWLimit <String>] [-VideoBWSessionLimit <String>] [-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 de ciertas modalidades. (En Microsoft Lync Server 2010, solo se pueden asignar limitaciones de ancho de banda a las modalidades de audio y vídeo.) Este cmdlet crea un perfil de contenedor para estas directivas. Al llamar a este cmdlet, defina las directivas individuales dentro del contenedor especificando las limitaciones de ancho de banda para audio y vídeo.
Para aplicar perfiles de directiva de ancho de banda a los sitios de red, es necesario llamar a los cmdlets New-CsNetworkSite o Set-CsNetworkSite.
Quién puede ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar el cmdlet New-CsNetworkBandwidthPolicyProfile 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-CsNetworkBandwidthPolicyProfile"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Identity |
Requerido |
XdsGlobalRelativeIdentity |
Un valor alfanumérico que identifica la directiva de forma única. Todos los perfiles de directiva de ancho de banda se crean en el ámbito global. Por ello, el ámbito está implícito y solo es necesario especificar un nombre único al crear un nuevo perfil de directiva de ancho de banda. Tenga en cuenta que este valor rellena también la propiedad BWPolicyProfileID del perfil. |
AudioBWLimit |
Opcional |
Cadena de caracteres |
La cantidad máxima de ancho de banda que se puede asignar a todas las conexiones de audio. Si una sola sesión de audio provoca que se exceda el límite de ancho de banda de audio, no se permitirá que dicha sesión se inicie. Expresado en kbps. Por ejemplo, un valor de 1000 significaría 1000 kbps. Si facilita un valor para este parámetro, no puede facilitar ningún valor al parámetro BWPolicy. Valor predeterminado: Si proporciona un valor al parámetro AudioBWSessionLimit, pero no a AudioBWLimit, AudioBWLimit se establece en 0 de manera predeterminada. |
AudioBWSessionLimit |
Opcional |
Cadena de caracteres |
La cantidad máxima de ancho de banda que se puede asignar a cada conexión de audio. Expresado en kbps. El valor debe ser mayor o igual que 40. Si facilita un valor para este parámetro, no puede facilitar ningún valor al parámetro BWPolicy. Valor predeterminado: si proporciona un valor al parámetro AudioBWLimit, pero no a AudioBWSessionLimit, AudioBWSessionLimit se establece en 175 de manera predeterminada. |
BWPolicy |
Opcional |
Modificador de lista PS |
Una lista de objetos que contienen perfiles de directiva de ancho de banda. Cada objeto de la lista consta de una modalidad de ancho de banda (audio o vídeo), una limitación de ancho de banda y una limitación de sesión de ancho de banda. Si facilita un valor para este parámetro, no puede facilitar ningún valor a los parámetros AudioBWLimit, AudioBWSessionLimit, VideoBWLimit ni VideoBWSessionLimit. Los objetos de la lista se pueden crear llamando al cmdlet New-CsNetworkBWPolicy. |
Description |
Opcional |
Cadena de caracteres |
Una descripción del perfil de directiva de ancho de banda. Por ejemplo, puede usar este parámetro para describir el uso para el que se ha diseñado el perfil. |
VideoBWLimit |
Opcional |
Cadena de caracteres |
La cantidad máxima de ancho de banda que se puede asignar a todas las conexiones de vídeo. Si una sola sesión de vídeo provoca que se exceda el límite de ancho de banda de vídeo, no se permitirá que dicha sesión inicie. Expresado en kbps. Por ejemplo, un valor de 1000 significaría 1000 kbps. Si facilita un valor para este parámetro, no puede facilitar ningún valor al parámetro BWPolicy. Valor predeterminado: si proporciona un valor al parámetro VideoBWSessionLimit, pero no a VideoBWLimit, VideoBWLimit se establece en 0 de manera predeterminada. |
VideoBWSessionLimit |
Opcional |
Cadena de caracteres |
La cantidad máxima de ancho de banda que se puede asignar a cada conexión de vídeo. Expresado en kbps. El valor debe ser mayor o igual que 100. Si facilita un valor para este parámetro, no puede facilitar ningún valor al parámetro BWPolicy. Valor predeterminado: Si proporciona un valor al parámetro VideoBWLimit, pero no a VideoBWSessionLimit, VideoBWSessionLimit se establece en 700 de manera predeterminada. |
Force |
Opcional |
Parámetro modificador |
Suprime las preguntas de confirmación que aparecerían antes de realizar cambios. |
InMemory |
Opcional |
Parámetro modificador |
Crea una referencia de objeto sin confirmar realmente el objeto como cambio permanente. Si se asigna la salida de este cmdlet llamado con este parámetro en una variable, puede realizar cambios en las propiedades de la referencia del objeto y después confirmar estos cambios, llamando a este conjunto coincidente de cmdlet, - cmdlet. |
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
Ninguno.
Tipos de valores devueltos
Crea un objeto de tipo Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.BWPolicyProfileType.
Ejemplo
-------------------------- Ejemplo 1 --------------------------
New-CsNetworkBandwidthPolicyProfile -Identity LowBWLimits -AudioBWLimit 2000 -AudioBWSessionLimit 200 -VideoBWLimit 1400 -VideoBWSessionLimit 500
En el Ejemplo 1 se crea un nuevo perfil de directiva de ancho de banda llamado LowBWLimits. Este nuevo perfil tendrá dos directivas asignadas, una de audio y otra de vídeo (las dos únicas posibles en Lync Server 2010). Para agregar al perfil la directiva de audio, se usa el parámetro AudioBWLimit para asignar un límite de 2000 kbps (en este caso) a todas las conexiones de audio, y el parámetro AudioBWSessionLimit para asignar un límite de 200 kbps a las sesiones de audio individuales. Para crear límites de sesiones de vídeo, se lleva a cabo el mismo proceso, pero utilizando los parámetros VideoBWLimit y VideoBWSessionLimit.