Condividi tramite

  • Articolo

Get-CsQoEConfiguration

 

Ultima modifica dell'argomento: 2012-03-23

Recupera una o più raccolte di impostazioni sulla qualità percepita dagli utenti (QoE, Quality of Experience).

Sintassi

Get-CsQoEConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]

Get-CsQoEConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>]

Descrizione dettagliata

Le metriche QoE registrano la qualità delle chiamate audio e video effettuate nell'organizzazione, includendo informazioni quali il numero di pacchetti di rete persi, i rumori di fondo e la quantità di "instabilità" (differenze nel ritardo dei pacchetti). Queste metriche vengono archiviate in un database separatamente rispetto ad altri dati, ad esempio la registrazione dettagli chiamata (CDR, Call Detail Record), in modo che sia possibile abilitare e disabilitare il servizio QoE in maniera indipendente rispetto ad altre registrazioni di dati. Utilizzare questo cmdlet per recuperare impostazioni che configurano QoE a livello globale o di sito.

QoE fa parte del ruolo Monitoring Server. È pertanto necessario distribuire il Monitoring Server nell'installazione di Microsoft Lync Server 2010 prima che la registrazione QoE abbia effetto o prima che sia possibile raccogliere i dati QoE.

Utenti autorizzati a eseguire il cmdlet: per impostazione predefinita, sono autorizzati a eseguire localmente il cmdlet Get-CsQoEConfiguration i membri dei seguenti gruppi: RTCUniversalUserAdmins, RTCUniversalServerAdmins. Per restituire un elenco di tutti i ruoli RBAC (Role-Based Access Control) a cui è stato assegnato questo cmdlet, inclusi gli eventuali ruoli RBAC personalizzati creati dall'utente, dal prompt di Windows PowerShell eseguire il seguente comando:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsQoEConfiguration"}

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Facoltativo

Identità XDS

l'identificatore univoco delle impostazioni che si desidera recuperare. I valori possibili sono global e site:<nome sito>, dove <nome sito> è il nome del sito nella distribuzione di Lync Server 2010 a cui si desidera applicare le modifiche.

Filter

Facoltativo

Stringa

Consente di utilizzare caratteri jolly per restituire una o più raccolte di impostazioni di configurazione QoE. Per restituire una raccolta di tutte le impostazioni configurate nell'ambito del sito, utilizzare la sintassi seguente: -Filter site:*. Per restituire una raccolta di tutte le impostazioni la cui identità (l'unica proprietà a cui è possibile applicare un filtro) contiene il valore stringa "Western", utilizzare la seguente sintassi: -Filter *Western*.

LocalStore

Facoltativo

Parametro opzionale

Recupera le impostazioni dalla replica locale dell'archivio di gestione centrale.

Tipi di input

Nessuno.

Tipi restituiti

Get-CsQoEConfiguration restituisce istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Settings.QoE.QoESettings.

Esempio

-------------------------- Esempio 1 --------------------------

Get-CsQoEConfiguration

In questo esempio viene utilizzato Get-CsQoEConfiguration per restituire una raccolta di tutte le impostazioni QoE configurate per l'utilizzo nell'organizzazione.

-------------------------- Esempio 2 --------------------------

Get-CsQoEConfiguration -Identity site:Redmond

Nell'esempio 2 viene utilizzato il parametro Identity per garantire che Get-CsQoEConfiguration restituisca solo le impostazioni QoE la cui identità è site:Redmond.

-------------------------- Esempio 3 --------------------------

Get-CsQoEConfiguration -Filter site:*

Nell'esempio 3 viene utilizzato il parametro Filter per restituire tutte le impostazioni QoE che sono state configurate nell'ambito del sito. La stringa con caratteri jolly "site:*" restituisce tutte le impostazioni QoE la cui identità inizia con il valore stringa site:. Le impostazioni che soddisfano questi criteri sono impostazioni configurate nell'ambito del sito.

-------------------------- Esempio 4 --------------------------

Get-CsQoEConfiguration | Where-Object {$_.KeepQoEDataForDays -lt 30}

Nell'esempio precedente viene restituita una raccolta di tutte le impostazioni QoE per le quali il valore della proprietà KeepQoEDataForDays è minore di 30 giorni. A tale scopo, nel comando viene innanzitutto utilizzato Get-CsQoEConfiguration per restituire una raccolta di tutte le impostazioni QoE configurate nell'organizzazione. Questa raccolta viene quindi inviata tramite pipe al cmdlet Where-Object, che applica un filtro che limita i dati restituiti alle impostazioni che hanno un valore KeepQoEDataForDays minore di 30 giorni.