Parameters

Call detail recording (CDR) provides a way for you to track usage of Microsoft Lync Server 2010 capabilities such as Voice over Internet Protocol (VoIP) phone calls; instant messaging; file transfers; audio/video (A/V) conferencing; and application sharing sessions. CDR (which is available only if you have deployed the Monitoring service) keeps usage information: it logs information such as the parties involved in the call; the length of the call; and whether or not any files were transferred.(However, CDR does not make a recording of the call itself.)

CDR also keeps track of call error information: detailed diagnostic data for both peer-to-peer sessions and for conferencing calls.

As an administrator, you can determine whether or not CDR is used in your organization. If Monitoring Service has been deployed, you can easily enable or disable CDR. In addition, you can make this decision globally (in which case CDR will either be enabled or disabled throughout the organization) or on a site-by-site basis; for example, you could use CDR in the Redmond site but not use CDR in the Paris site.

Site-specific settings you create by using New-CsCdrConfiguration can later be removed by using the Remove-CsCdrConfiguration cmdlet. When you remove site-specific settings, then CDR for the affected site will automatically be governed by the global CDR configuration settings.

You can also run Remove-CsCdrConfiguration against the global CDR settings. However, because the global settings cannot be removed, they will instead be reset to their default values. For example, suppose, you set the value of the KeepCallDetailForDays property in the global settings to 90. If you run Remove-CsCdrConfiguration against the global settings, that property will be reset to its default value of 60.

Who can run this cmdlet: By default, members of the following groups are authorized to run the Remove-CsCdrConfiguration cmdlet locally: RTCUniversalServerAdmins. To return a list of all the role-based access control (RBAC) roles this cmdlet has been assigned to (including any custom RBAC roles you have created yourself), run the following command from the Windows PowerShell prompt:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsCdrConfiguration"}

Microsoft.Rtc.Management.WritableConfig.Settings.CallDetailRecording.CdrSettings. Remove-CsCdrConfiguration accepts pipelined input of CDR configuration objects.

None. Instead, the cmdlet deletes instances of the Microsoft.Rtc.Management.WritableConfig.Settings.CallDetailRecording.CdrSettings object.

-------------------------- Example 1 --------------------------

	Copy Code
Remove-CsCdrConfiguration -Identity site:Redmond

The preceding command uses Remove-CsCdrConfiguration to remove the CDR settings assigned to the Redmond site. Using the Identity parameter ensures that only the settings assigned to the specified site will be removed.

-------------------------- Example 2 --------------------------

	Copy Code
Get-CsCdrConfiguration -Filter site:* | Remove-CsCdrConfiguration

The command shown in Example 2 removes all the CDR settings that have been assigned at the site scope. To do this, the command first uses Get-CsCdrConfiguration and the Filter parameter to retrieve the appropriate CDR settings; the string value "site:*" ensures that only those settings that have an Identity that begins with the characters "site:" are returned. The filtered collection is then piped to Remove-CsCdrConfiguration, which deletes all the items in the collection.

-------------------------- Example 3 --------------------------

	Copy Code
Get-CsCdrConfiguration | Where-Object {$_.KeepCallDetailForDays -lt 30} | Remove-CsCdrConfiguration

In Example 3, any CDR settings where the KeepCallDetailForDays property is less than 30 days are deleted. To carry out this task, the command calls Get-CsCdrConfiguration without any parameters in order to return a collection of all the CDR settings currently in use in the organization. This collection is then piped to the Where-Object cmdlet, which picks out only those settings where the KeepCallDetailForDays property is less than 30 days. The filtered collection is then piped to Remove-CsCdrConfiguration, which deletes each item in that collection.

Other Resources