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。使用這個指令程式在通用或網站層級上修改配置 QoE 的設定。
QoE 是 監控伺服器 角色的一部分；因此，在 QoE 記錄生效之前或可收集任何 QoE 資料之前，您必須在 Microsoft Lync Server 2010 安裝中部署 監控伺服器。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Set-CsQoEConfiguration Cmdlet：RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsQoEConfiguration"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Identity |
選用 |
XdsIdentity |
您要修改之設定的唯一識別碼。可能的值為 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 不會傳回值或物件。反之，指令程式會設定 Microsoft.Rtc.Management.WritableConfig.Settings.QoE.QoESettings 物件的執行個體。
範例
-------------------------- 範例 1 --------------------------
Set-CsQoEConfiguration -Identity site:Redmond -EnableQoE $False
範例 1 的命令使用 Set-CsQoEConfiguration 指令程式修改 Redmon 網站 (-Identity site:Redmond) 的經驗品質設定。新設定透過將 EnableQoE 參數設為 False，以關閉 QoE。
-------------------------- 範例 2 --------------------------
Set-CsQoEConfiguration -Identity site:Dublin -KeepQoEDataForDays 45 -PurgeHourOfDay 4
這個命令會修改套用至 Dublin 網站的 QoE 設定。在這個範例中，我們將 KeepQoEDataForDays 參數設為 45，所以 QoE 資料在 45 天後會從資料庫中清除。此外，我們將 PurgeHourOfDay 參數設為 4，表示任何資料只要超過剛指定的 45 天，都會在上午 4:00 清除。
附註：如果您已啟用 QoE 和詳細通話記錄 (CDR)，基於效能的緣故，最好確認 QoE 的 PurgeHourOfDay 設定不同於 CDR 的 PurgeHourOfDay 設定。