Get-CsQoEConfiguration
Última modificación del tema: 2012-03-23
Recupera una o varias colecciones de configuraciones de calidad de la experiencia (QoE).
Sintaxis
Get-CsQoEConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]
Get-CsQoEConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>]
Descripción detallada
Las métricas QoE controlan la calidad de las llamadas de audio y vídeo de la organización, incluyen datos sobre el número de paquetes perdidos, el ruido de fondo y la cantidad de "vibración" (diferencias en el retraso de paquetes). Esta información se almacena en una base de datos independiente de otros datos, como los registros de detalles de llamadas, lo que permite habilitar y deshabilitar QoE de manera independiente de otros datos registrados. Este cmdlet permite recuperar opciones de configuración de QoE a nivel global o de sitio.
Las métricas QoE forman parte del rol de Servidor de supervisión; por lo tanto, el Servidor de supervisión debe estar implementado en la instalación de Microsoft Lync Server 2010 para que el registro de QoE tenga efecto o para que se puedan recopilar datos de QoE.
Quién puede ejecutar este cmdlet: de manera predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar localmente el cmdlet Get-CsQoEConfiguration: RTCUniversalUserAdmins, 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 "Get-CsQoEConfiguration"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Identity |
Opcional |
Identidad Xds |
Identificador único de la configuración que se quiere recuperar. Los valores admitidos son "global" y "site:<nombre del sitio>", donde "<nombre del sitio> es el nombre del sitio de la implementación de Lync Server 2010 en el que se desean aplicar los cambios. |
Filter |
Opcional |
Cadena de caracteres |
Permite usar caracteres comodín para devolver una o varias recopilaciones de opciones de configuración de QoE. Para devolver una recopilación de todas las opciones de configuración del sitio, use esta sintaxis: -Filter site:*. Para devolver una recopilación de todas las configuraciones que tengan el valor de cadena de caracteres "oeste" en cualquier ubicación del valor Identity (la única propiedad que se puede filtrar), use esta sintaxis: -Filter *oeste*. |
LocalStore |
Opcional |
Parámetro modificador |
Recupera la configuración de la réplica local del Almacén de administración central. |
Tipos de entrada
Ninguno.
Tipos de valores devueltos
Get-CsQoEConfiguration devuelve instancias del objeto Microsoft.Rtc.Management.WritableConfig.Settings.QoE.QoESettings.
Ejemplo
-------------------------- Ejemplo 1 --------------------------
Get-CsQoEConfiguration
Este ejemplo usa Get-CsQoEConfiguration para devolver una colección de todas las opciones de QoE configuradas para su uso en la organización.
-------------------------- Ejemplo 2 --------------------------
Get-CsQoEConfiguration -Identity site:Redmond
En el Ejemplo 2 se usa el parámetro Identity para garantizar que Get-CsQoEConfiguration solo devuelve la configuración de QoE con la identidad site:Redmond.
-------------------------- Ejemplo 3 --------------------------
Get-CsQoEConfiguration -Filter site:*
En el Ejemplo 3, se usa el parámetro Filter para devolver todas las opciones de QoE que se hayan configurado en el ámbito del sitio. El comodín "site:*" devuelve todas las configuraciones de QoE con un valor de Identity que comience con la cadena de caracteres site:. Las configuraciones que cumplen estos criterios son las que se han configurado en el ámbito del sitio.
-------------------------- Ejemplo 4 --------------------------
Get-CsQoEConfiguration | Where-Object {$_.KeepQoEDataForDays -lt 30}
El ejemplo anterior devuelve una colección de todas las configuraciones de QoE en las que la propiedad KeepQoEDataForDays es menor que 30 días. Para ello, el comando primero usa Get-CsQoEConfiguration para devolver una colección de todas las configuraciones de QoE definidas en la organización. Dicha colección se transfiere al cmdlet Where-Object, que aplica un filtro para limitar los datos que se devuelven a las configuraciones que tengan un valor de KeepQoEDataForDays inferior a 30 días.