New-CsBandwidthPolicyServiceConfiguration
Última modificación del tema: 2012-03-23
Crea una nueva configuración del servicio de directivas de ancho de banda.
Sintaxis
New-CsBandwidthPolicyServiceConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-EnableLogging <$true | $false>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-LogCleanUpInterval <TimeSpan>] [-MaxLogFileSizeMb <UInt32>] [-MaxTokenLifetime <TimeSpan>] [-WhatIf [<SwitchParameter>]]
Descripción detallada
El control de admisión de llamadas (CAC) es una manera de determinar si se permitirá que las sesiones de comunicaciones en tiempo real, como las video llamadas y las llamadas de voz, se establezcan en base a las restricciones de ancho de banda. En la implementación de Microsoft Lync Server 2010 de CAC, las regiones, los sitios y las subredes se definen en una red junto con las relaciones y los vínculos entre dichas entidades para establecer restricciones de ancho de banda entre ellas. El servicio de directivas de ancho de banda es un componente que cumple con la funcionalidad de CAC en la implementación de Lync Server 2010, lo que habilita a tomar decisiones sobre si existe suficiente ancho de banda para realizar una llamada. Este cmdlet configura un nuevo servicio de directivas de ancho de banda en el nivel del sitio.
Quiénes pueden ejecutar este cmdlet: De manera predeterminada, los miembros de los siguientes grupos están autorizados para ejecutar el cmdlet New-CsBandwidthPolicyServiceConfiguration en forma local: 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 "New-CsBandwidthPolicyServiceConfiguration"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Identity |
Requerido |
Identidad Xds |
Identificador único que contiene el ámbito y el nombre de la configuración. Esta configuración sólo se puede crear en el ámbito del sitio; por consiguiente, el parámetro Identity tendrá el siguiente formato: site:<site name>, donde <site name> es el nombre del sitio al que se aplica la configuración. |
EnableLogging |
Opcional |
Booleano |
Defina este parámetro en True para generar un error de CAC y registros de estado de vínculos relacionados con el servicio de directivas de ancho de banda. Valor predeterminado: False |
LogCleanUpInterval |
Opcional |
TimeSpan |
El período después del cual se quitarán el error de CAC y los registros de estado de vínculos. Este valor debe estar dentro del rango de 1 a 60 días. El valor debe escribirse en el formato dd.hh:mm:ss, donde "d" es día, "h" es hora, "m" es minuto y "s" es segundo. Valor predeterminado: 10 días (10.00:00:00) |
MaxLogFileSizeMb |
Opcional |
UInt32 |
El tamaño máximo que puede alcanzar el archivo de registro. El valor de este parámetro debe ser un número positivo y el tamaño de archivo debe especificarse en megabytes. Valor predeterminado: 3 (MB) |
MaxTokenLifetime |
Opcional |
TimeSpan |
El tiempo máximo que existirá es el token emitido por el servicio de autenticación de directivas de ancho de banda. Este valor debe estar dentro del rango de 1 a 24 horas. El valor debe escribirse en el formato dd.hh:mm:ss, donde "d" es día, "h" es hora, "m" es minuto y "s" es segundo. Valor predeterminado: 8 horas (08:00:00) |
Force |
Opcional |
Parámetro modificador |
Suprime las solicitudes de confirmación que, de lo contrario, se mostrarí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.BandwidthPolicyServiceConfiguration.BandwidthPolicyServiceConfiguration.
Ejemplo
-------------------------- Ejemplo 1 --------------------------
New-CsBandwidthPolicyServiceConfiguration -Identity site:Redmond
En este ejemplo, se crea una nueva configuración de servicio de directivas de ancho de banda en el sitio Redmond (-Identity site:Redmond). Como no se especifican otros parámetros, se usan los valores predeterminados para toda la configuración.
-------------------------- Ejemplo 2 --------------------------
New-CsBandwidthPolicyServiceConfiguration -Identity site:Dublin -EnableLogging $True -LogCleanupInterval 30.00:00:00
Nuevamente en este ejemplo, creamos una nueva configuración de servicio de directivas de ancho de banda, pero esta vez para el sitio Dublin (-Identity site:Dublin). Para este sitio, en lugar de aceptar los valores predeterminados queremos habilitar el registro y definir en 30 días el período que debe pasar antes de que se limpien los registros. Esto se hace al pasar un valor True ($True) al parámetro EnableLogging, y, a continuación, al pasar un valor de 30.00:00:00 al parámetro LogCleanupInterval. El valor LogCleanupInterval es un objeto TimeSpan que debe escribirse en el formato dd.hh:mm:ss, donde "d" es día, "h" es hora, "m" es minuto y "s" es segundo.