Remove-CsQoEConfiguration
上一次修改主题： 2012-03-27
删除 QoE（用户体验质量）设置的集合。
语法
Remove-CsQoEConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
详细说明
QoE 指标会对组织中进行的音频和视频呼叫的质量进行跟踪，包括丢失的网络数据包数目、背景噪音和“抖动”量（数据包延迟的差异）等。这些指标与其他数据（如呼叫详细信息记录）分开存储在一个数据库中，这样您就可以独立于其他数据记录启用和禁用 QoE。使用此 cmdlet 可删除用于在站点级别配置 QoE 的设置。在全局 QoE 配置上调用此 cmdlet 会将所有属性都重置为默认值。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Remove-CsQoEConfiguration cmdlet：RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsQoEConfiguration"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
必需 |
Xds 标识 |
要删除的设置的唯一标识符。可采用的值为 global 和 site:<site name>，其中 <site name> 是 Microsoft Lync Server 2010 部署中具有要删除的设置的站点的名称。 |
Force |
可选 |
开关参数 |
禁止显示任何本该在进行更改前显示的确认提示。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况（无需实际执行命令）。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
Microsoft.Rtc.Management.WritableConfig.Settings.QoE.QoESettings 对象。接受通过管道传递的 QoE 配置对象的输入。
返回类型
此 cmdlet 不返回值或对象。它会删除 Microsoft.Rtc.Management.WritableConfig.Settings.QoE.QoESettings 对象的实例。
示例
-------------------------- 示例 1 --------------------------
Remove-CsQoEConfiguration -Identity site:Redmond
上述命令使用 Remove-CsQoEConfiguration 删除分配给站点 Redmond 的 QoE 设置。使用 Identity 参数可确保仅删除分配给指定站点的设置。
-------------------------- 示例 2 --------------------------
Get-CsQoEConfiguration -Filter site:* | Remove-CsQoEConfiguration
示例 2 中显示的命令删除已在站点范围内分配的所有 QoE 设置。为执行此操作，该命令首先使用 Get-CsQoEConfiguration 和 Filter 参数检索相应的 QoE 设置；通配符字符串“site:*”可确保仅返回标识以字符串值 site: 开头的那些设置。然后，将筛选出的集合通过管道传递给 Remove-CsQoEConfiguration，后者将删除集合中的所有项。
-------------------------- 示例 3 --------------------------
Get-CsQoEConfiguration | Where-Object {$_.KeepQoEDataForDays -lt 30} | Remove-CsQoEConfiguration
示例 3 中删除 KeepQoEDataForDays 属性小于 30 的任何 QoE 设置。为实现此任务，该命令调用 Get-CsQoEConfiguration（无任何参数）返回组织中当前正在使用的所有 QoE 设置的集合。然后，将此集合通过管道传递到 Where-Object cmdlet，后者仅挑选出 KeepQoEDataForDays 属性小于 (-lt) 30 天的那些设置。接下来，将筛选出的集合通过管道传递给 Remove-CsQoEConfiguration，后者将删除该集合中的每项。