Set-CsQoEConfiguration
上一次修改主题： 2012-03-26
修改现有的 QoE（用户体验质量）设置集合。
语法
Set-CsQoEConfiguration [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-EnableExternalConsumer <$true | $false>] [-EnablePurging <$true | $false>] [-EnableQoE <$true | $false>] [-ExternalConsumerIssuedCertId <IssuedCertId>] [-ExternalConsumerName <String>] [-ExternalConsumerURL <String>] [-Force <SwitchParameter>] [-KeepQoEDataForDays <UInt32>] [-PurgeHourOfDay <UInt32>] [-WhatIf [<SwitchParameter>]]
Set-CsQoEConfiguration [-Confirm [<SwitchParameter>]] [-EnableExternalConsumer <$true | $false>] [-EnablePurging <$true | $false>] [-EnableQoE <$true | $false>] [-ExternalConsumerIssuedCertId <IssuedCertId>] [-ExternalConsumerName <String>] [-ExternalConsumerURL <String>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-KeepQoEDataForDays <UInt32>] [-PurgeHourOfDay <UInt32>] [-WhatIf [<SwitchParameter>]]
详细说明
QoE 指标用于跟踪组织中发出的语音和视频呼叫的质量，包括网络数据包丢失数目、背景噪音、“抖动”量（数据包延迟的差异）等。这些指标与其他数据（如呼叫详细信息记录）分开存储在一个数据库中，这样您就可以独立于其他数据记录启用和禁用 QoE。使用此 cmdlet 可以修改在全局级别或站点级别配置 QoE 的设置。
QoE 是监控服务器角色的一部分；因此，只有在 Microsoft Lync Server 2010 安装上部署监控服务器后，QoE 记录才会生效或者才能收集任何 QoE 数据。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Set-CsQoEConfiguration cmdlet：RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsQoEConfiguration"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
可选 |
Xds 标识 |
要修改的设置的唯一标识符。可能的值为 global 和 site:<site name>，其中 <site name> 是要应用更改的 Lync Server 2010 部署中的站点名称。 |
Instance |
可选 |
QoESettings |
QoE 配置对象的对象引用。此对象必须为 QoESettings 类型，并且可以通过调用 Get-CsQoEConfiguration 来检索。 |
EnableExternalConsumer |
可选 |
布尔值 |
指定外部使用者是否能够接收 QoE 报告。 |
EnablePurging |
可选 |
布尔值 |
指定在经过 KeepQoEDataForDays 属性中定义的持续时间后是否清除记录。 |
EnableQoE |
可选 |
布尔值 |
指定是否收集 QoE 记录并将其保存到监控数据库。 请注意，即使 EnableQoE 设置为 True，也不会收集 QoE 数据，除非已部署监控服务器并与注册器池相关联。 |
ExternalConsumerIssuedCertId |
可选 |
IssuedCertId |
允许访问外部使用者 Web 服务的证书的证书 ID。 |
ExternalConsumerName |
可选 |
字符串 |
QoE 报告的外部使用者的友好名称。 |
ExternalConsumerURL |
可选 |
字符串 |
将对其发布 QoE 报告的外部使用者的 URL。 |
KeepQoEDataForDays |
可选 |
UInt32 |
QoE 数据在从数据库中清除之前可以存储的天数。如果 EnablePurging 设置为 False，将忽略该值。 该值必须介于 1 到 2562 之间。 |
PurgeHourOfDay |
可选 |
UInt32 |
一天中清除存储时间超过 KeepQoEDataForDays 属性中指定天数的 QoE 记录的整点数。 该值必须介于 0 到 23 之间，表示一天中的整点数。例如，0 表示午夜，13 表示下午 1:00。 |
Force |
可选 |
开关参数 |
在进行更改前取消可能另外显示的任何确认提示。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况（无需实际执行命令）。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
Microsoft.Rtc.Management.WritableConfig.Settings.QoE.QoESettings 对象。接受通过管道传递的 QoE 配置对象的输入。
返回类型
Set-CsQoEConfiguration 并不返回值或对象。此 cmdlet 会配置 Microsoft.Rtc.Management.WritableConfig.Settings.QoE.QoESettings 对象的实例。
示例
-------------------------- 示例 1 --------------------------
Set-CsQoEConfiguration -Identity site:Redmond -EnableQoE $False
示例 1 中的命令使用 Set-CsQoEConfiguration cmdlet 修改 Redmond 站点 (-Identity site:Redmond) 的用户体验质量设置。新设置通过将 EnableQoE 参数设置为 False 来关闭 QoE。
-------------------------- 示例 2 --------------------------
Set-CsQoEConfiguration -Identity site:Dublin -KeepQoEDataForDays 45 -PurgeHourOfDay 4
此命令修改应用于 Dublin 站点的 QoE 设置。在此示例中，KeepQoEDataForDays 参数设置为 45，因此 45 天后将从数据库中清除 QoE 数据。此外，PurgeHourOfDay 参数设置为 4，这表示将在上午 4:00 清除存储时间超过刚刚指定的 45 天的所有数据。
注意：如果已启用 QoE 和呼叫详细信息记录 (CDR)，则出于性能原因，最好确保 QoE 和 CDR 的 PurgeHourOfDay 设置不同。