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。使用此指令程式可建立在網站層級設定 QoE 的設定 (根據預設，通用層級的設定已存在，且無法移除)。
QoE 是 監控伺服器 角色的一部分；因此，在 QoE 記錄生效之前或可收集任何 QoE 資料之前，您必須在 Microsoft Lync Server 2010 安裝中部署 監控伺服器。
誰可以執行此 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 指令程式建立 Identity 為 site:Redmond 的一組新經驗品質設定。除了 Identity site:Redmond 以外，新設定也會將 EnableQoE 屬性設為 False。網站設定的優先順序高於通用設定，因此，這表示將會停用 Redmond 網站的 QoE，不論在全域範圍是否已啟用 QoE 都一樣。
-------------------------- 範例 2 --------------------------
New-CsQoEConfiguration -Identity site:Dublin -KeepQoEDataForDays 30 -PurgeHourOfDay 4
此命令會建立套用至 Dublin 網站的新 QoE 設定。在此範例中，我們已將 KeepQoEDataForDays 參數設為 30，因此 QoE 資料將在 30 天 (而不是預設的 60 天) 後從資料庫清除。此外，我們已將 PurgeHourOfDay 參數設為 4，表示超過我們剛才指定的 30 天的任何資料都將在上午 4:00 清除。
附註：如果您已啟用 QoE 和詳細通話記錄 (CDR)，基於效能的緣故，最好確認 QoE 的 PurgeHourOfDay 設定不同於 CDR 的 PurgeHourOfDay 設定。