Set-CsNetworkBandwidthPolicyProfile
Última modificación del tema: 2012-03-26
Modifica un perfil de directiva de ancho de banda de red existente.
Sintaxis
Set-CsNetworkBandwidthPolicyProfile [-Identity <XdsGlobalRelativeIdentity>] [-AudioBWLimit <String>] [-AudioBWSessionLimit <String>] [-BWPolicy <PSListModifier>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-VideoBWLimit <String>] [-VideoBWSessionLimit <String>] [-WhatIf [<SwitchParameter>]]
Set-CsNetworkBandwidthPolicyProfile [-AudioBWLimit <String>] [-AudioBWSessionLimit <String>] [-BWPolicy <PSListModifier>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-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 modifica un perfil de contenedor para estas directivas.
IMPORTANTE: Si un perfil contiene múltiples directivas (por ejemplo, una directiva de audio y otra de vídeo), al modificar el perfil usando las propiedades de AudioBWLimit, AudioBWSessionLimit, VideoBWLimit o VideoBWSessionLimit se eliminarán todas las directivas existentes en el perfil y se sustituirán con los nuevos valores. Si el perfil incluía una directiva para limitar el vídeo y sólo configura el parámetro AudioBWLimit, la directiva de vídeo se eliminará y se creará una directiva de audio.
Quién puede ejecutar este cmdlet: de forma predeterminada, los miembros de los siguientes grupos tienen autorización para ejecutar el cmdlet Set-CsNetworkBandwidthPolicyProfile localmente: RTCUniversalServerAdmins. Para obtener una lista de todos los roles de control de acceso basado en rol (RBAC), este rol se ha asignado (así como cualquier otro rol RBAC personalizado que haya creado) para ejecutar el siguiente comando desde el símbolo del sistema Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsNetworkBandwidthPolicyProfile"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Identity |
Opcional |
XdsGlobalRelativeIdentity |
El valor de cadena que identifica de manera unívoca el perfil de directiva de ancho de banda que desea modificar. Es idéntico a la propiedad BWPolicyProfileID del perfil y puede cambiarse mediante el cambio del valor de dicha propiedad. Esta operación es equivalente a "cortar y pegar": todas las propiedades del perfil serán las mismas y sólo cambiará el nombre. Sin embargo, este valor no puede cambiarse si el perfil se asigna a un sitio de red. |
Instance |
Opcional |
BWPolicyProfileType |
Una referencia a un objeto de perfil de directiva de ancho de banda (un objeto del tipo Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.BWPolicyProfileType) que contiene la configuración que se desea usar para modificar el perfil. Este objeto se puede recuperar llamando al cmdlet Get-CsNetworkBandwidthPolicyProfile. |
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 facilita un valor para el parámetro AudioBWSessionLimit, pero no para AudioBWLimit, AudioBWLimit se establecerá de forma predeterminada en 0. |
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 facilita un valor para el parámetro AudioBWLimit, pero no para AudioBWSessionLimit, AudioBWSessionLimit se establecerá de forma predeterminada en 175. |
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 deben ser del tipo Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.BWPolicyType. Los objetos de este tipo se pueden crear llamando al cmdlet New-CsNetworkBWPolicy y la directiva resultante se puede agregar al perfil asignándola como valor a este parámetro. |
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 facilita un valor para el parámetro VideoBWSessionLimit, pero no para VideoBWLimit, VideoBWLimit se establecerá de forma predeterminada en 0. |
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 facilita un valor para el parámetro VideoBWLimit, pero no para VideoBWSessionLimit, VideoBWSessionLimit se establecerá de forma predeterminada en 700. |
Force |
Opcional |
Parámetro modificador |
Suprime las preguntas de confirmación que aparecerí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 la entrada transferida de objetos de perfil de directiva de ancho de banda de red.
Tipos de valores devueltos
Este cmdlet no devuelve un valor. Modifica un objeto del tipo Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.BWPolicyProfileType.
Ejemplo
-------------------------- Ejemplo 1 --------------------------
Set-CsNetworkBandwidthPolicyProfile -Identity LowBWProfile -Description "Policy for links of less than 10MB"
En este ejemplo se modifica la descripción del perfil de directiva de ancho de banda con la identidad LowBWProfile. Esto se hace llamando a Set-CsNetworkBandwidthPolicyProfile con dos parámetros: Identity, que especifica el nombre del perfil que modificar, y Description, que especifica la nueva descripción del perfil.
-------------------------- Ejemplo 2 --------------------------
Set-CsNetworkBandwidthPolicyProfile -Identity LowBWLimit -VideoBWLimit 2500 -VideoBWSessionLimit 300
En el ejemplo 2 se modifica el límite general y el límite de las sesiones de transmisión de vídeo para el perfil de la directiva de ancho de banda con Identidad LowBWLimit. Después de especificar el valor de Identity del perfil que se va a cambiar, usamos a continuación el parámetro VideoBWLimit para establecer el límite general de vídeo en 2500. Después, usamos el parámetro VideoBWSessionLimit para establecer el límite de sesión individual en 300. Este comando agregará un perfil de vídeo o actualizará uno existente para el perfil de la directiva de ancho de banda LowBWLimit. Los perfiles existentes de audio no se verán afectados.
-------------------------- Ejemplo 3 --------------------------
$bp = New-CsNetworkBWPolicy -BWLimit 5000 -BWSessionLimit 200 -BWPolicyModality video
Set-CsNetworkBandwidthPolicyProfile -Identity LowBWLimit -BWPolicy $bp
En este ejemplo se crea una nueva directiva de ancho de banda y se asigna al perfil de la directiva de ancho de banda con Identidad LowBWLimit. La primera línea de este ejemplo es una llamada al cmdlet New-CsNetworkBWPolicy. Este cmdlet crea un nuevo perfil, en este caso un perfil de vídeo (-BWPolicyModality video) con un límite de 5.000 kbps (-BWLimit 5000) y un límite de sesión de 200 kbps (-BWSessionLimit 200). Este nuevo objeto de perfil se almacena en la variable $bp. La siguiente línea de este ejemplo llama a Set-CsNetworkBandwidthPolicyProfile para modificar el perfil LowBWLimit (-Identity LowBWLimit). El parámetro BWPolicy se usa con un valor de $bp. Esto sustituye cualquier directiva existente de este perfil por la directiva recién creada almacenada en la variable $bp.
-------------------------- Ejemplo 4 --------------------------
$a = Get-CsNetworkBandwidthPolicyProfile -Identity LowBWProfile
$ap = New-CsNetworkBWPolicy -BWLimit 2000 -BWSessionLimit 300 -BWPolicyModality audio
$a.BWPolicy.Add($ap)
Set-CsNetworkBandwidthPolicyProfile -Instance $a
En el ejemplo se 4 agrega una nueva directiva de ancho de banda de audio al conjunto de directivas existentes en el perfil LowBWProfile. En la línea 1 se llama a Get-CsNetworkBandwidthPolicyProfile para recuperar el perfil con Identity LowBWProfile. Dicho perfil se almacena en la variable $a. En la siguiente línea, se llama a New-CsNetworkBWPolicy para crear una nueva directiva de ancho de banda. Esta directiva es una directiva de audio (-BWPolicyModality audio) con un límite de 2.000 kbps (-BWLimit 2000) y un límite de sesión de 300 kbps (-BWSessionLimit 300). Esta nueva directiva se almacena en la variable $ap.
En la línea 3, se agrega la nueva directiva de audio (almacenada en $ap) al perfil recuperado en la línea 1 (y almacenado en la variable $a). Esto se hace abriendo el método Agregar de la propiedad BWPolicy del perfil, pasando un valor de $ap. Esto puede leerse como "Agregar la nueva directiva almacenada en $ap a BWPolicy del perfil LowBWProfile (almacenado en $a)".
Para acabar, se llama a Set-CsNetworkBandwidthPolicyProfile para actualizar el perfil LowBWProfile. Usamos el parámetro Instance y pasamos un valor de $a, que contiene el perfil modificado.
-------------------------- Ejemplo 5 --------------------------
$ap = New-CsNetworkBWPolicy -BWLimit 2000 -BWSessionLimit 300 -BWPolicyModality audio
Set-CsNetworkBandwidthPolicyProfile -Identity LowBWProfile -BWPolicy @{add=$ap}
El Ejemplo 5 es idéntico en funcionalidad al Ejemplo 4: agrega una nueva directiva de audio a la lista existente de directivas para el perfil LowBWProfile. Este método necesita de menos líneas, pero puede no ser tan claro. Lo hemos incluido para demostrar que hay formas diferentes de hacer lo mismo.
En la línea 1, se crea una nueva directiva de ancho de banda de audio que establece un límite de ancho de banda (2.000) y de sesión (300) y almacena el nuevo objeto en la variable $ap. Después, se llama a Set-CsNetworkBandwidthPolicyProfile para modificar el perfil con Identity igual a LowBWProfile. Se usa el parámetro BWPolicy para modificar la lista de directivas del perfil. Tenga en cuenta el valor que se ha pasado a este parámetro: @{add=$ap}. Así es cómo Windows PowerShell agrega algo a una lista. Se comienza con el símbolo @, seguido por un conjunto de llaves {}. Dentro de dichas llaves, se puede especificar la acción que se desea realizar en la lista (en este caso, queremos agregar a la lista). (También puede eliminar o sustituir). Se continúa con la acción (agregar) con un símbolo de igual, seguida por el objeto que queremos agregar a la lista (en este caso, la nueva directiva almacenada en la variable $ap).