New-CsQoEConfiguration
Última modificación del tema: 2012-03-25
Crea una nueva recopilación de configuraciones de QoE (calidad de la experiencia).
Sintaxis
New-CsQoEConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-EnableExternalConsumer <$true | $false>] [-EnablePurging <$true | $false>] [-EnableQoE <$true | $false>] [-ExternalConsumerIssuedCertId <IssuedCertId>] [-ExternalConsumerName <String>] [-ExternalConsumerURL <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-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 de su organización, que incluyen la cantidad de paquetes de red perdidos, el ruido de fondo y la cantidad de "vibración" (diferencias en el retraso de paquete). Estas métricas se almacenan en una base de datos independiente de otros datos (como los registros de detalles de llamadas), lo que permite habilitar y deshabilitar las métricas QoE de manera independiente de otros datos registrados. Use este cmdlet para crear configuraciones para la QoE en el nivel del sitio. (Las configuraciones en el nivel global existen de manera predeterminada y no se pueden quitar).
Las métricas QoE forman parte del rol del Servidor de supervisión; por lo tanto, Servidor de supervisión debe estar implementado en la instalación de Microsoft Lync Server 2010 antes de que el registro de QoE se lleve a cabo o de que puedan recopilarse los datos de QoE.
Quiénes pueden ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar el cmdlet New-CsQoEConfiguration localmente: 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-CsQoEConfiguration"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Identity |
Requerido |
Identidad Xds |
El sitio al que se aplican las nuevas configuraciones. Esto debe escribirse en el formato site:<site name>, en donde <site name> es el nombre del sitio en su implementación de Lync Server 2010. |
EnableExternalConsumer |
Opcional |
Booleano |
Especifica si un cliente externo puede recibir los informes de QoE. Valor predeterminado: False |
EnablePurging |
Opcional |
Booleano |
Especifica si los registros se purgarán después de que la duración definida en la propiedad KeepQoEDataForDays haya finalizado. Valor predeterminado: True |
EnableQoE |
Opcional |
Booleano |
Especifica si los registros de QoE se recopilarán y guardarán en la base de datos de supervisión. Tenga en cuenta que si EnableQoE se configura en el valor True, los datos de QoE no se recopilarán a menos que Servidor de supervisión haya sido implementado y se haya asociado con un grupo de registradores. Valor predeterminado: True |
ExternalConsumerIssuedCertId |
Opcional |
IssuedCertId |
El Id. de certificado que permite obtener acceso al servicio web del cliente externo. |
ExternalConsumerName |
Opcional |
Cadena de caracteres |
El nombre del cliente externo del informe de QoE. |
ExternalConsumerURL |
Opcional |
Cadena de caracteres |
La URL del cliente externo al cual se publicarán los informes de QoE. |
KeepQoEDataForDays |
Opcional |
UInt32 |
La cantidad de días en que los datos de QoE se almacenarán antes de que se purguen de la base de datos. Este valor se ignora si EnablePurging está definido en False. Debe ser un valor de 1 a 2562. Valor predeterminado: 60 |
PurgeHourOfDay |
Opcional |
UInt32 |
La hora del día en que los registros de QoE que superaron la cantidad de días especificados en la propiedad KeepQoEDataForDays se purgarán. Debe ser un valor de 0 a 23, que represente la hora del día. Por ejemplo, 0 sería la medianoche; 13 sería la 1:00 p. m. Valor predeterminado: 1 |
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.QoE.QoESettings.
Ejemplo
-------------------------- Ejemplo 1 --------------------------
New-CsQoEConfiguration -Identity site:Redmond -EnableQoE $False
El comando en el Ejemplo 1 usa el cmdlet New-CsQoEConfiguration para crear un nuevo conjunto de configuraciones de calidad de la experiencia con el parámetro Identity site:Redmond. Además de Identity site:Redmond, las configuraciones nuevas tienen la propiedad EnableQoE establecida en False. Como las configuraciones del sitio tienen prioridad sobre las configuraciones globales, QoE estará deshabilitada para Redmond site, independientemente de si QoE se habilitó en el ámbito global.
-------------------------- Ejemplo 2 --------------------------
New-CsQoEConfiguration -Identity site:Dublin -KeepQoEDataForDays 30 -PurgeHourOfDay 4
Este comando crea nuevas configuraciones de QoE que se aplican a Dublin site. En este ejemplo, se estableció el parámetro KeepQoEDataForDays en 30, de manera que los datos de QoE se purgarán de la base de datos después de 30 días, en lugar de purgarse cada 60 días como es la forma predeterminada. Además, se definió el parámetro PurgeHourOfDay en 4, lo que significa que todos los datos de más de 30 días que se especificaron se purgarán a las 4:00 AM.
Nota: Si habilitó QoE y los registros de detalles de llamadas (CDR), por motivos de rendimiento, se recomienda asegurarse de que la configuración PurgeHourOfDay sea diferente para QoE y CDR.