Set-CsQoEConfiguration
Última modificación del tema: 2012-03-26
Modifica una colección existente de configuraciones de Calidad de la experiencia (QoE, Quality of Experience).
Sintaxis
Set-CsQoEConfiguration [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-EnableExternalConsumer <$true | $false>] [-EnablePurging <$true | $false>] [-EnableQoE <$true | $false>] [-ExternalConsumerIssuedCertId <IssuedCertId>] [-ExternalConsumerName <String>] [-ExternalConsumerURL <String>] [-Force <SwitchParameter>] [-KeepQoEDataForDays <UInt32>] [-PurgeHourOfDay <UInt32>] [-WhatIf [<SwitchParameter>]]
Set-CsQoEConfiguration [-Confirm [<SwitchParameter>]] [-EnableExternalConsumer <$true | $false>] [-EnablePurging <$true | $false>] [-EnableQoE <$true | $false>] [-ExternalConsumerIssuedCertId <IssuedCertId>] [-ExternalConsumerName <String>] [-ExternalConsumerURL <String>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-KeepQoEDataForDays <UInt32>] [-PurgeHourOfDay <UInt32>] [-WhatIf [<SwitchParameter>]]
Descripción detallada
Las métricas de QoE realizan un seguimiento de la calidad de las llamadas de audio y vídeo que se han efectuado en la organización, incluido el número de paquetes de red 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 otras estadísticas, como los registros de detalles de llamadas, lo que permite activar y desactivar las métricas QoE de manera independiente de otros datos registrados. Este cmdlet se utiliza para modificar las opciones de configuran QoE en el nivel global o de sitio.
Las métricas QoE forman parte del rol Servidor de supervisión; por lo tanto, dicho servidor debe estar implementado en la instalación de Microsoft Lync Server 2010 para poder activar QoE o recopilar estadísticas QoE de cualquier tipo.
Quién puede ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar el cmdlet Set-CsQoEConfiguration 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 "Set-CsQoEConfiguration"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Identity |
Opcional |
Identidad Xds |
El identificador único de la configuración que se quiere modificar. Los valores admitidos son "global" y "site:<nombre del sitio>"; "<nombre del sitio> es el nombre del sitio de la implementación de Lync Server 2010 en el que se quieren aplicar los cambios. |
Instance |
Opcional |
QoESettings |
Una referencia de objeto a un objeto de configuración de QoE. Este objeto debe ser de tipo QoESettings y puede recuperarse llamando a Get-CsQoEConfiguration. |
EnableExternalConsumer |
Opcional |
Booleano |
Especifica si un consumidor externo puede recibir informes de QoE. |
EnablePurging |
Opcional |
Booleano |
Especifica si los registros se purgarán una vez transcurrida la duración definida en la propiedad KeepQoEDataForDays. |
EnableQoE |
Opcional |
Booleano |
Especifica si los registros QoE se recopilarán y guardarán en la base de datos de supervisión. Tenga en cuenta que, aun cuando EnableQoE esté establecido en True, los datos de QoE no se recopilarán a menos que Servidor de supervisión se haya implementado y asociado a un grupo del registrador. |
ExternalConsumerIssuedCertId |
Opcional |
IssuedCertId |
El id. de certificado del certificado que permite el acceso al servicio web del consumidor externo. |
ExternalConsumerName |
Opcional |
Cadena de caracteres |
El nombre descriptivo del consumidor externo del informe de QoE. |
ExternalConsumerURL |
Opcional |
Cadena de caracteres |
La URL del consumidor externo al que se enviarán los informes de QoE. |
KeepQoEDataForDays |
Opcional |
UInt32 |
El número de días que los datos de QoE permanecerán almacenados antes de purgarse de la base de datos. Este valor se ignora si EnablePurging está establecido en False. Debe ser un valor entre 1 y 2.562. |
PurgeHourOfDay |
Opcional |
UInt32 |
La hora del día a la que se purgarán los registros de QoE que han superado el número de días especificado en la propiedad KeepQoEDataForDays. Debe ser un valor entre 0 y 23 que represente la hora del día. Por ejemplo, 0 será medianoche y 13 será las 13:00. |
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.QoE.QoESettings. Acepta la entrada transferida de objetos de configuración de QoE.
Tipos de valores devueltos
Set-CsQoEConfiguration no devuelve un valor u objeto. En su lugar, el cmdlet configura instancias del objeto Microsoft.Rtc.Management.WritableConfig.Settings.QoE.QoESettings.
Ejemplo
-------------------------- Ejemplo 1 --------------------------
Set-CsQoEConfiguration -Identity site:Redmond -EnableQoE $False
El comando del Ejemplo 1 utiliza el cmdlet Set-CsQoEConfiguration para modificar la configuración de Calidad de experiencia para el sitio Redmond (-Identity site:Redmond). La nueva configuración desactivará QoE estableciendo el parámetro EnableQoE en False.
-------------------------- Ejemplo 2 --------------------------
Set-CsQoEConfiguration -Identity site:Dublin -KeepQoEDataForDays 45 -PurgeHourOfDay 4
Este comando modifica la configuración de QoE que se aplica al sitio Dublin. En este ejemplo, hemos establecido el parámetro KeepQoEDataForDays en 45, de modo que los datos de QoE se purgarán de la base de datos transcurridos 45 días. Además, hemos establecido el parámetro PurgeHourOfDay en 4, lo que significa que hemos especificado que todos los datos que tengan más de 45 días se purguen a las 4:00.
Nota: si ha habilitado QoE y los registros de detalles de las llamadas (CDR), por motivos de rendimiento, se recomienda asegurarse de que la configuración PurgeHourOfDay sea diferente para QoE y CDR.