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