[This is preliminary documentation and is subject to change. Blank topics are included as placeholders.]

Removes a collection of QoE (Quality of Experience) settings.


Remove-CsQoEConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]


Parameter Required Type Description




The unique identifier of the settings you want to remove. Possible values are global and site:<site name>, where <site name> is the name of the site in your Microsoft Communications Server 2010 deployment with the settings to be removed.




Prompts you for confirmation before executing the command.







Describes what would happen if you executed the command without actually executing the command.

Detailed Description

QoE metrics track the quality of audio and video calls made in your organization, including such things as the number of network packets lost, background noise, and the amount of "jitter" (differences in packet delay). These metrics are stored in a database apart from other data (such as Call Detail Recrods), which allows you to enable and disable QoE independent of other data recording. Use this cmdlet to remove settings that configure QoE at the site level. Calling this cmdlet on the global QoE configuration will reset all properties to the defaults.

QoE is part of the Monitoring Server role; therefore Monitoring Server must be deployed on your Microsoft Communications Server 2010 installation before QoE recording can be enabled.

Return Types

This cmdlet does not return a value or object. Instead, it removes instances of the Microsoft.Rtc.Management.WriteableConfig.Settings.QoE.QoESettings object.


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

Copy Code
Remove-CsQoEConfiguration -Identity site:Redmond

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

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

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

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

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

Copy Code
Get-CsQoEConfiguration | Where-Object {$_.KeepQoEDataForDays -lt 30} | Remove-CsQoEConfiguration

In Example 3, any QoE settings where the KeepQoEDataForDays property is less than 30 are deleted. To carry out this task, the command calls Get-CsQoEConfiguration, without any parameters, in order to return a collection of all the QoE 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 KeepQoEDataForDays property is less than (-lt) 30 days. In turn, the filtered collection is piped to Remove-CsQoEConfiguration, which deletes each item in that collection.