Remove-CsCdrConfiguration
Última modificación del tema: 2012-03-26
Quita la colección especificada de opciones de configuración del registro de detalles de llamadas (CDR). CDR permite realizar un seguimiento de uso de aspectos como las sesiones de mensajería instantánea de punto a punto, llamadas telefónicas de voz sobre IP (VoIP) y llamadas en conferencia. Estos datos de uso abarcan información sobre quién llamó a quién, cuándo se llamó y la duración de la llamada.
Sintaxis
Remove-CsCdrConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Descripción detallada
El registro de detalles de llamadas (CDR) permite controlar el uso de funciones de Microsoft Lync Server 2010, como las llamadas telefónicas de VoIP, la mensajería instantánea, las transferencias de archivos, las conferencias de audio/vídeo y las sesiones de aplicaciones compartidas. El CDR (disponible únicamente si se ha implementado el servicio de supervisión) guarda la información de uso: participantes de la llamada, duración de la llamada y si se han transferido archivos o no (la llamada en sí no se registra).
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 llamadas en conferencia.
En tanto que administrador, puede determinar si se usa o no CDR en la organización. Si se ha implementado el servicio de supervisión, puede habilitar o deshabilitar CDR rápidamente. 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.
Las opciones de configuración específicas del sitio creadas usando New-CsCdrConfiguration se pueden eliminar más adelante usando el cmdlet Remove-CsCdrConfiguration. Cuando elimina opciones de configuración específicas del sitio, el registro de detalles de llamadas (CDR) del sitio afectado se regirá automáticamente por las opciones de configuración del CDR global.
También puede ejecutar Remove-CsCdrConfiguration con la configuración de CDR. Sin embargo, dado que la configuración global no se puede quitar, se restablecerá en su lugar en los valores predeterminados. Por ejemplo, suponga que establece el valor de la propiedad KeepCallDetailForDays de la configuración global en 90. Si ejecuta Remove-CsCdrConfiguration en la configuración global, la propiedad se restablecerá en su valor predeterminado de 60.
Quién puede ejecutar este cmdlet: de forma predeterminada, los miembros de los siguientes grupos tienen autorización para ejecutar el cmdlet Remove-CsCdrConfiguration localmente: RTCUniversalServerAdmins. Para obtener una lista de todos los roles de control de acceso basado en rol (RBAC), este rol se ha asignado (así como cualquier otro rol RBAC personalizado que haya creado) para ejecutar el siguiente comando desde el símbolo del sistema Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsCdrConfiguration"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Identity |
Requerido |
Identidad Xds |
Identificador único para la configuración de CDR que se va a quitar. Para "quitar" la configuración global, use la siguiente sintaxis: -Identity global. (De nuevo, recuerde que en realidad la configuración global no se puede quitar, sino que únicamente se pueden restablecer las propiedades en los valores predeterminados). Para quitar la configuración del ámbito de sitio, use la sintaxis del siguiente ejemplo: -Identity site:Redmond. No puede usar caracteres comodín para especificar una identidad. |
Force |
Opcional |
Parámetro modificador |
Suprime la visualización de los mensajes de error que no son graves y que pueden surgir 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. Remove-CsCdrConfiguration acepta la entrada transferida de objetos de configuración de CDR.
Tipos de valores devueltos
Ninguno. En su lugar, el cmdlet elimina las instancias del objeto Microsoft.Rtc.Management.WritableConfig.Settings.CallDetailRecording.CdrSettings.
Ejemplo
-------------------------- Ejemplo 1 --------------------------
Remove-CsCdrConfiguration -Identity site:Redmond
El comando anterior usa Remove-CsCdrConfiguration para eliminar la configuración de CDR asignada al sitio Redmond. El uso del parámetro Identity hace que solo se eliminen las opciones asignadas al sitio especificado.
-------------------------- Ejemplo 2 --------------------------
Get-CsCdrConfiguration -Filter site:* | Remove-CsCdrConfiguration
El comando que se muestra en el ejemplo 2 quita todas las opciones de configuración de CDR que se han asignado al ámbito del sitio. Para ello, el comando usa primero Get-CsCdrConfiguration y el parámetro Filter para recuperar los valores adecuados de CDR. El valor de cadena "site:*" hace que solo se devuelvan los valores en los que Identity comienza por el valor de cadena "site:". A continuación, la colección filtrada se transfiere a Remove-CsCdrConfiguration, que elimina todos los elementos de la recopilación.
-------------------------- Ejemplo 3 --------------------------
Get-CsCdrConfiguration | Where-Object {$_.KeepCallDetailForDays -lt 30} | Remove-CsCdrConfiguration
En el ejemplo 3 se elimina cualquier configuración de CDR donde la propiedad KeepCallDetailForDays sea menor de 30 días. Para realizar esta tarea, el comando llama primero a Get-CsCdrConfiguration sin parámetros para devolver una colección de todos los valores de CDR que la organización usa actualmente. Esta colección después se transfiere al cmdlet Where-Object, que selecciona solo los valores en los que la propiedad KeepCallDetailForDays es inferior a 30 días. A continuación, la recopilación filtrada se transfiere a Remove-CsCdrConfiguration, que elimina cada elemento de la recopilación.