Get-CsBandwidthPolicyServiceConfiguration
Última modificación del tema: 2012-03-23
Recupera una o más configuraciones de servicios de directivas de ancho de banda.
Sintaxis
Get-CsBandwidthPolicyServiceConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]
Get-CsBandwidthPolicyServiceConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>]
Descripción detallada
El control de admisión de llamadas (CAC) es una forma de determinar si se debe permitir que las sesiones de comunicación en tiempo real, como las llamadas de voz o video, se establezcan según 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 el componente que ejecuta la funcionalidad CAC en la implementación de Lync Server 2010 y permite establecer si el ancho de banda es suficiente para establecer una llamada. El cmdlet Get-CsBandwidthPolicyServiceConfiguration recupera las configuraciones de uno o más servicios de directivas de ancho de banda.
Quiénes pueden ejecutar este cmdlet: De forma predeterminada, los miembros de los grupos siguientes están autorizados a ejecutar el cmdlet Get-CsBandwidthPolicyServiceConfiguration de forma local: RTCUniversalUserAdmins, 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 "Get-CsBandwidthPolicyServiceConfiguration"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Identity |
Opcional |
Identidad Xds |
Identificador único de la configuración que se quiere recuperar. Este identificador se compone del ámbito (para la configuración global) o del ámbito y el nombre (para una configuración a nivel del sitio, por ejemplo, site:Redmond). |
Filter |
Opcional |
Cadena de caracteres |
Cadena que contiene uno o más caracteres de comodines que se usarán para buscar las propiedades de identidad de todas las configuraciones de servicio de directivas de ancho de banda para encontrar todas las configuraciones cuya identidad coincide con el patrón de comodines. Por ejemplo, el valor de Filter site:* recuperará todas las configuraciones con valores de identidad que comiencen con la cadena site: y finalizan con cualquier conjunto de caracteres. |
LocalStore |
Opcional |
Parámetro modificador |
Recupera la configuración del servicio de directivas de ancho de banda de la réplica local de Almacén de administración central, en lugar de Almacén de administración central en sí. |
Tipos de entrada
Ninguno.
Tipos de valores devueltos
Recupera uno o más objetos del tipo Microsoft.Rtc.Management.WritableConfig.Settings.BandwidthPolicyServiceConfiguration.BandwidthPolicyServiceConfiguration.
Ejemplo
-------------------------- Ejemplo 1 --------------------------
Get-CsBandwidthPolicyServiceConfiguration
En el Ejemplo 1 se recuperan todas las configuraciones de servicio de directivas de ancho de banda definidas dentro de la implementación de Microsoft Lync Server 2010.
-------------------------- Ejemplo 2 --------------------------
Get-CsBandwidthPolicyServiceConfiguration -Identity site:Redmond
En este ejemplo, se recupera la configuración de servicio de directivas de ancho de banda definida para el sitio Redmond (-Identity site:Redmond).
-------------------------- Ejemplo 3 --------------------------
Get-CsBandwidthPolicyServiceConfiguration -Filter site:*
En este ejemplo, usamos el parámetro Filter para recuperar todas las configuraciones de servicio de directivas de ancho de banda definidas a nivel del sitio. Para ello, pasamos el valor site:* al parámetro Filter. De este modo, se busca la propiedad Identity de todas las configuraciones de servicio de directivas de ancho de banda para valores que comienzan con site: y están seguidos de cualquier otro carácter. Debido a que todas las configuraciones a nivel del sitio tienen valores Identity que comienzan con site: y están seguidas del nombre del sitio, este filtro encontrará todas las configuraciones de todos los sitios.
-------------------------- Ejemplo 4 --------------------------
Get-CsBandwidthPolicyServiceConfiguration | Where-Object {$_.MaxLogFileSizeMb -gt 4}
En el Ejemplo 4 se recuperan todas las configuraciones de servicio de directivas de ancho de banda que permite a los archivos de registro alcanzar tamaños mayores que cuatro megabytes. El ejemplo comienza con una llamada realizada al cmdlet Get-CsBandwidthPolicyServiceConfiguration. Como se observó en el Ejemplo 1, este cmdlet recupera una recopilación de todas las configuraciones definidas dentro de la implementación de Lync Server. A continuación, esta recopilación se canaliza al cmdlet Where-Object. Where-Object se coloca en ciclos de la recopilación con un elemento a la vez. Para cada elemento de la recopilación, Where-Object realiza una comprobación para ver si el valor de la propiedad MaxLogFileSizeMb es mayor que (-gt) 4. En ese caso, el elemento sigue siendo parte de la recopilación y es parte del resultado del comando. Si el valor de MaxLogFileSizeMb no es mayor que 4, el elemento es ignorado y no se devolverá.