Get-CsQoEConfiguration
上次修改主題的時間： 2012-03-23
擷取一或多個品質經驗 (QoE) 設定的集合。
語法
Get-CsQoEConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]
Get-CsQoEConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>]
詳細描述
QoE 計量追蹤在組織中建立的音訊和視訊撥號品質，包括遺失的網路封包數量、背景雜訊和「抖動」(封包延遲差異) 量。這些計量都會儲存在資料庫中，除了其他資料 (例如詳細通話記錄) 之外，讓您可啟用和停用與其他資料記錄無關的 QoE。使用這個指令程式來擷取在通用或站台層級設定 QoE 的設定。
QoE 是 監控伺服器 角色的一部分；因此，在 QoE 記錄生效之前或可收集任何 QoE 資料之前，您必須在 Microsoft Lync Server 2010 安裝中部署 監控伺服器。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Get-CsQoEConfiguration Cmdlet：RTCUniversalUserAdmins、RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsQoEConfiguration"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Identity |
選用 |
XdsIdentity |
您要擷取之設定的唯一識別碼。可能的值為 global 和 site:<site name>，其中 <site name> 是 Lync Server 2010 在部署中要套用變更的站台名稱。 |
Filter |
選用 |
字串 |
可讓您使用萬用字元，以傳回一或多個 QoE 組態設定的集合。若要傳回在站台範圍所設定之所有設定集合，請使用此語法：-Filter site:*。若要傳回在其 Identity (您可篩選的唯一屬性) 某處具有字串值 "Western" 的所有設定集合，請使用此語法：-Filter *Western*。 |
LocalStore |
選用 |
切換參數 |
從 中央管理存放區 的本機複本擷取設定。 |
輸入類型
無。
傳回類型
Get-CsQoEConfiguration 會傳回 Microsoft.Rtc.Management.WritableConfig.Settings.QoE.QoESettings 物件的執行個體。
範例
-------------------------- 範例 1 --------------------------
Get-CsQoEConfiguration
這個範例使用 Get-CsQoEConfiguration 來傳回針對在組織中使用而設定之所有 QoE 設定的集合。
-------------------------- 範例 2 --------------------------
Get-CsQoEConfiguration -Identity site:Redmond
範例 2 使用 Identity 參數，確保 Get-CsQoEConfiguration 僅傳回 Identity 為 site:Redmond 的 QoE 設定。
-------------------------- 範例 3 --------------------------
Get-CsQoEConfiguration -Filter site:*
在範例 3 中，Filter 參數可用來傳回已在站台範圍設定的所有 QoE 設定。萬用字元 "site:*" 傳回 Identity 是以字串值 site: 開頭的所有 QoE 設定。符合該準則的設定是已在站台範圍設定的設定。
-------------------------- 範例 4 --------------------------
Get-CsQoEConfiguration | Where-Object {$_.KeepQoEDataForDays -lt 30}
上述範例會傳回其 KeepQoEDataForDays 屬性小於 30 天之所有 QoE 設定的集合。為達成此目的，命令先使用 Get-CsQoEConfiguration 以傳回組織中所有設定之 QoE 設定的集合。接著將該集合傳送給 Where-Object 指令程式，由它套用篩選，將傳回的資料限於 KeepQoEDataForDays 值早於 30 天的設定。