Get-CsCdrConfiguration
Última modificación del tema: 2012-03-23
Devuelve información acerca de la configuración de registro de detalles de llamadas (CDR). CDR le permite realizar el seguimiento del uso de elementos como las sesiones de mensajería de voz punto a punto, las llamadas telefónicas de voz sobre IP (VoIP) y las llamadas en conferencia.
Sintaxis
Get-CsCdrConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]
Get-CsCdrConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>]
Descripción detallada
El registro de detalles de llamadas (CDR) brinda una manera de realizar el seguimiento del uso de funciones de Microsoft Lync Server 2010, como llamadas telefónicas de voz sobre IP, mensajería instantánea (MI), transferencias de archivos, conferencias de audio/vídeo (A/V) y sesiones de uso compartido de aplicaciones. CDR (que está disponible solamente si ha implementado el servicio de supervisión) mantiene la información de uso: registra información, por ejemplo, los participantes de la llamada, la duración de la llamada y la posibilidad de que se haya llevado a cabo la transferencia de archivos. (Sin embargo, CDR no registra la llamada en sí).
CDR, además, mantiene un seguimiento de los errores de la llamada: datos de diagnóstico detallados de sesiones punto a punto y para llamadas en conferencia.
Como administrador, puede determinar si se usa CDR en su organización. En caso de que se haya implementado el servicio de supervisión, puede habilitar o deshabilitar CDR. Además, puede tomar esta decisión de manera global (en cuyo caso CDR se habilitará o se deshabilitará en toda la organización) o sitio por sitio; por ejemplo, puede usar CDR en Redmond site, pero en Paris site.
El cmdlet Get-CsCdrConfiguration brinda una manera que le permite devolver información detallada acerca de cómo se usa CDR en su organización.
Quiénes pueden ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar el cmdlet Get-CsCdrConfiguration localmente: 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-CsCdrConfiguration"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Identity |
Opcional |
Identidad Xds |
Indica el único identificador para la recopilación de la configuración de CDR que desea devolver. Para hacer referencia a la configuración global, use la siguiente sintaxis: -Identity global. Para hacer referencia a una recopilación configurada en el ámbito del sitio, use una sintaxis similar a la siguiente: -Identity site:Redmond. Tenga en cuenta que no es posible usar comodines al especificar un parámetro Identity. Si necesita usar caracteres comodín, use el parámetro Filter. Por lo tanto, si este parámetro no se especifica, Get-CsCdrConfiguration devolverá una recopilación de todas las opciones de configuración de CDR que se encuentran actualmente en uso en la organización. |
Filter |
Opcional |
Cadena de caracteres |
Permite que use caracteres comodines para devolver una recopilación de configuraciones de CDR. Por ejemplo, para devolver una recopilación de todas las configuraciones definidas en el ámbito del sitio, use la sintaxis: -Filter site:*. Para devolver una recopilación de todas las configuraciones que tienen el valor de cadena "Western" en alguna parte del parámetro Identity, use esta sintaxis: -Filter *Western*. |
LocalStore |
Opcional |
Parámetro modificador |
Recupera los datos de configuración de CDR 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. Get-CsCdrConfiguration no acepta entradas canalizadas.
Tipos de valores devueltos
Get-CsCdrConfiguration devuelve instancias del objeto Microsoft.Rtc.Management.WritableConfig.Settings.CallDetailRecording.CdrSettings.
Ejemplo
-------------------------- Ejemplo 1 --------------------------
Get-CsCdrConfiguration
Este ejemplo usa Get-CsCdrConfiguration para devolver una recopilación de todas las configuraciones de CDR para usar en la organización.
-------------------------- Ejemplo 2 --------------------------
Get-CsCdrConfiguration -Identity site:Redmond
El Ejemplo 2 usa el parámetro Identity para devolver una única recopilación de configuraciones de CDR: la configuración con el parámetro Identity site:Redmond.
-------------------------- Ejemplo 3 --------------------------
Get-CsCdrConfiguration -Filter site:*
En el Ejemplo 3, se usa el parámetro Filter para devolver todas las configuraciones de CDR que se hayan configurado en el ámbito del sitio. El valor del filtro "site:*" devuelve todas las configuraciones de CDR que tienen una Identidad que comienza con el valor de cadena "site:" Por definición, esas configuraciones son las que se realizaron en el ámbito del sitio.
-------------------------- Ejemplo 4 --------------------------
Get-CsCdrConfiguration | Where-Object {$_.KeepCallDetailForDays -lt 30}
El ejemplo precedente devuelve solamente una recopilación de todas las configuraciones de CDR en donde la propiedad KeepCallDetailForDays es menor a 30 días. Para ello, el comando, primero, usa Get-CsCdrConfiguration para devolver una recopilación de todas las configuraciones de CDR realizadas en la organización. A continuación, esta recopilación se canaliza al cmdlet Where-Object, que selecciona sólo aquellas configuraciones donde el valor KeepCallDetailForDays es menor a 30 días.