Remove-CsQoEConfiguration
上次修改主題的時間： 2012-03-27
移除 QoE (經驗品質) 設定的集合。
語法
Remove-CsQoEConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
詳細描述
QoE 計量會追蹤組織內執行的音訊與視訊通話品質，包括網路封包遺失數目、背景雜訊，以及「抖動」(封包延遲中的差異) 的數目等等。這些計量都會儲存在資料庫中，除了其他資料 (例如詳細通話記錄) 之外，讓您可啟用和停用與其他資料記錄無關的 QoE。使用此指令程式可移除在網站層級設定 QoE 的設定。在通用 QoE 組態呼叫此指令程式會將所有屬性重設為預設值。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Remove-CsQoEConfiguration Cmdlet：RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsQoEConfiguration"}
參數
| 參數 | 必要 | 類型 | 說明 |
|---|---|---|---|
Identity |
必要 |
Xds 識別碼 |
您要移除之設定的唯一識別碼。可能的值為 global 和 site:<網站名稱>，其中 <網站名稱> 是您 Microsoft Lync Server 2010 部署中具有要移除之設定的網站的名稱。 |
Force |
選用 |
切換參數 |
抑制在進行變更前可能顯示的任何確認提示。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果，但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
Microsoft.Rtc.Management.WritableConfig.Settings.QoE.QoESettings 物件。接受 QoE 組態物件的管線傳送資料。
傳回類型
這個指令程式不會傳回值或物件，反之，會移除 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:*" 可確保只傳回 Identity 開頭為字串值 site: 的設定。接著，篩選過的集合會傳送到 Remove-CsQoEConfiguration，以刪除集合中的所有項目。
-------------------------- 範例 3 --------------------------
Get-CsQoEConfiguration | Where-Object {$_.KeepQoEDataForDays -lt 30} | Remove-CsQoEConfiguration
在範例 3 中，會刪除 KeepQoEDataForDays 屬性小於 30 的所有 QoE 設定。若要執行此工作，此命令會呼叫不含任何參數的 Get-CsQoEConfiguration，以傳回目前用於組織之所有 QoE 設定的集合。接著，此集合會傳送到 Where-Object 指令程式，這樣會只挑出 KeepQoEDataForDays 屬性小於 (-lt) 30 天的設定。然後，篩選過的集合會傳送到 Remove-CsQoEConfiguration，這會刪除該集合中的每一個項目。