Set-CsCdrConfiguration
Última modificación del tema: 2012-03-26
Modifica una colección de configuraciones de registro detallado de llamadas (CDR). CDR permite controlar, por ejemplo, el uso de sesiones de mensajería instantánea punto a punto, las llamadas de teléfono de voz sobre IP (VOIP) y las llamadas de conferencias. Estos datos de uso incluyen información sobre quién ha llamado a quién, cuándo y durante cuánto tiempo han hablado.
Sintaxis
Set-CsCdrConfiguration [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-EnableCDR <$true | $false>] [-EnablePurging <$true | $false>] [-Force <SwitchParameter>] [-KeepCallDetailForDays <UInt32>] [-KeepErrorReportForDays <UInt32>] [-PurgeHourOfDay <UInt32>] [-WhatIf [<SwitchParameter>]]
Set-CsCdrConfiguration [-Confirm [<SwitchParameter>]] [-EnableCDR <$true | $false>] [-EnablePurging <$true | $false>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-KeepCallDetailForDays <UInt32>] [-KeepErrorReportForDays <UInt32>] [-PurgeHourOfDay <UInt32>] [-WhatIf [<SwitchParameter>]]
Descripción detallada
El registro de detalles de llamadas (CDR) permite controlar el uso de funciones de Microsoft Lync Server 2010, como llamadas telefónicas de voz sobre IP (VoIP), mensajería instantánea (IM), transferencias de archivos, conferencias de audio/vídeo (A/V) y sesiones de aplicaciones compartidas. El CDR (disponible únicamente si se ha implementado el servicio de supervisión) guarda la información de uso: registra información como las partes que intervienen en la llamada, la duración de la llamada y si se han transferido archivos. Sin embargo, el CDR no registra la llamada propiamente dicha.
Por otra parte, el CDR realiza un seguimiento de la información de errores: datos de diagnóstico detallados de sesiones punto a punto y conferencias.
Como un administrador, puede determinar si se usa o no CDR en la organización; si se asume que el servicio de supervisión se implementó, puede habilitar o deshabilitar CDR rápidamente. Además, se puede tomar la decisión de forma global (en cuyo caso, el CDR estará habilitado o deshabilitado en toda la organización) o sitio por sitio. Por ejemplo, se puede utilizar el CDR en el sitio de Redmond, pero no en el de París.
Los administradores también pueden gestionar la base de datos de CDR, por ejemplo, especificando la cantidad de días que se mantienen los registros de CDR antes de purgarse de la base de datos. Se pueden realizar cambios como estos mediante el cmdlet Set-CsCdrConfiguration.
Quién puede ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar el cmdlet Set-CsCdrConfiguration 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-CsCdrConfiguration"}
Parámetros
Parámetro | Requerido | Tipo | Descripción |
---|---|---|---|
Identity |
Opcional |
Identidad Xds |
Identificador único asignado a la colección de opciones de configuración de CDR. Para hacer referencia a la configuración global, use la siguiente sintaxis: -Identity global. Para hacer referencia a una colección configurada en el ámbito de sitio, use una sintaxis similar a ésta: -Identity site:Redmond. Tenga en cuenta que no se pueden utilizar caracteres comodín al especificar una Identidad. Si no se especifica este parámetro, Set-CsCdrConfiguration modificará la configuración global. |
Instance |
Opcional |
Objeto CdrSettings |
Permite enviar una referencia a un objeto al cmdlet, en lugar de definir valores de parámetros individuales. |
EnableCDR |
Opcional |
Booleano |
Indica si el CDR está habilitado. El valor predeterminado es True. |
EnablePurging |
Opcional |
Booleano |
Indica si los registros de CDR se eliminarán periódicamente de la base de datos de registro. Si se define como True (valor predeterminado), los registros se eliminarán una vez transcurrido el periodo de tiempo especificado mediante las propiedades KeepCallDetailForDays (para los registros CDR) y KeepErrorReportForDays (para errores de CDR). Si es False, los registros de CDR se mantendrán por tiempo indefinido. |
KeepCallDetailForDays |
Opcional |
Entero |
Indica el número de días que los registros de CDR se conservarán en la base de datos de registro; los registros con una antigüedad superior al número de días especificado se eliminarán automáticamente. (Tenga en cuenta que solo se realizará el purgado si la propiedad EnablePurging tiene el valor True). Puede definir esta propiedad en cualquier valor entero entre 1 y 2562 días (aproximadamente 7 años). El valor predeterminado es 60. |
KeepErrorReportForDays |
Opcional |
Entero |
Indica el número de días que se conservarán los informes de errores de CDR; cualquier informe con una antigüedad superior al número de días especificado se eliminará automáticamente. Los informes de errores de CDR son informes de diagnóstico cargados por aplicaciones cliente, como Microsoft Lync 2010. Puede definir esta propiedad en cualquier valor entero entre 1 y 2562 días (aproximadamente 7 años). El valor predeterminado es 60. |
PurgeHourOfDay |
Opcional |
Entero |
Indica la hora local del día en que se eliminan los registros que hayan expirado de la base de datos de CDR. La hora del día se especifica utilizando el formato de 24 horas, de modo que 0 representa la medianoche (12:00 a. m.) y 23 representa las 11:00 p.m. Tenga en cuenta que solo se puede especificar la hora del día, es decir, puede programar el purgado para las 4:00 a. m., pero no para las 4:30 a. m. ni las 4:15 a. m. El valor predeterminado es 2 (2:00 a. m.). Se recomienda realizar el purgado fuera del horario laboral. Solo se realiza el purgado de la base de datos si el valor de la propiedad EnablePurging es True. |
Force |
Opcional |
Parámetro modificador |
Suprime la visualización de los mensajes de error que no sean graves y que puedan ocurrir al ejecutar el comando. |
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
Microsoft.Rtc.Management.WritableConfig.Settings.CallDetailRecording.CdrSettings. Set-CsCdrConfiguration acepta la entrada transmitida de los objetos de configuración de registro de detalles de llamada.
Tipos de valores devueltos
Set-CsCdrConfiguration no devuelve un valor u objeto. En su lugar, el cmdlet configura instancias del objeto Microsoft.Rtc.Management.WritableConfig.Settings.CallDetailRecording.CDRSettings.
Ejemplo
-------------------------- Ejemplo 1 --------------------------
Set-CsCdrConfiguration -Identity site:Redmond -PurgeHourOfDay 23
El ejemplo anterior define la hora del día en que se purgarán los registros antiguos. En este caso, se ha fijado la hora en 23 (11:00 p. m. en el formato de 24 horas). El parámetro Identity se usa para garantizar que estos cambios se apliquen solo a las configuraciones de CDR cuya Identidad sea site:Redmond.
-------------------------- Ejemplo 2 --------------------------
Get-CsCdrConfiguration | Set-CsCdrConfiguration -PurgeHourOfDay 23
El Ejemplo 2 es una variación del comando que se muestra en el Ejemplo 1; en este caso, la propiedad PurgeHourOfDay se modifica en todas las recopilaciones de opciones de configuración de CDR que usa actualmente la organización. Para hacerlo, se llama primero a Get-CsCdrConfiguration sin ningún parámetro para devolver una colección de todas las configuraciones de CDR que se usan actualmente. A continuación, se transfiere esta colección a Set-CsCdrConfiguration, que cambia en todos los elementos de la colección la propiedad PurgeHourOfDay a las 11:00 p. m. (23).
-------------------------- Ejemplo 3 --------------------------
Get-CsCdrConfiguration -Filter "site:*"| Set-CsCdrConfiguration -PurgeHourOfDay 23
Otra variación del comando usado en el Ejemplo 1 se muestra en el Ejemplo 3. En este caso, la propiedad PurgeHourOfDay se cambia en todas las configuraciones de CDR definidas en el ámbito de sitio. Para realizar esta tarea, el comando llama primero a Get-CsCdrConfiguration junto con el parámetro Filter; el valor de filtro "site:*" garantiza que solo se devolverá la configuración de CDR que tiene una Identidad que comienza con el valor de cadena "site:" . La colección filtrada se transfiere a Set-CsCdrConfiguration, que modifica la propiedad PurgeHourOfDay de todos los elementos de esa colección.