Condividi tramite

  • Articolo

Set-CsQoEConfiguration

 

Ultima modifica dell'argomento: 2012-03-26

Modifica una raccolta esistente di impostazioni di qualità percepita dagli utenti (QoE, Quality of Experience).

Sintassi

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>]]

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 memorizzate in un database a parte quale, ad esempio, registrazione dettagli chiamata (CDR, Call Detail Record), in modo che sia possibile abilitare e disabilitare il servizio QoE indipendentemente dalle altre registrazioni di dati. Utilizzare questo cmdlet per modificare le impostazioni che configurano QoE a livello globale o di sito.

QoE fa parte del ruolo Monitoring Server, di conseguenza è 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 che possono eseguire questo cmdlet: per impostazione predefinita, i membri dei gruppi riportati di seguito sono autorizzati ad eseguire il cmdlet Set-CsQoEConfiguration in locale: RTCUniversalServerAdmins. Per restituire un elenco di tutti i ruoli RBAC (Role-Based Access Control, controllo dell'accesso basato sui ruoli) a cui è stato assegnato questo cmdlet (compresi eventuali ruoli RBAC personalizzati creati autonomamente), eseguire il cmdlet riportato di seguito dal prompt di Windows PowerShell:

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

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Facoltativo

Identità XDS

L'identificatore univoco delle impostazioni da modificare. 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.

Instance

Facoltativo

QoESettings

Un riferimento oggetto a un oggetto di configurazione QoE. Questo oggetto deve essere di tipo QoESettings e può essere recuperato chiamando Get-CsQoEConfiguration.

EnableExternalConsumer

Facoltativo

Booleano

Consente di specificare se un consumer esterno è in grado di ricevere i report QoE.

EnablePurging

Facoltativo

Booleano

Consente di specificare se i record saranno eliminati una volta trascorso il tempo definito nella proprietà KeepQoEDataForDays.

EnableQoE

Facoltativo

Booleano

Consente di specificare se i record QoE saranno raccolti e salvati nel database di monitoraggio.

Anche se EnableQoE è impostato su True, i dati QoE non saranno raccolti se non è stato distribuito un Monitoring Server successivamente associato a un pool di registrazione.

ExternalConsumerIssuedCertId

Facoltativo

IssuedCertId

L'ID del certificato che consente l'accesso al servizio Web del consumer esterno.

ExternalConsumerName

Facoltativo

Stringa

Il nome descrittivo del consumer esterno del report QoE.

ExternalConsumerURL

Facoltativo

Stringa

L'URL del consumer esterno in cui saranno pubblicati i report QoE.

KeepQoEDataForDays

Facoltativo

UInt32

Il numero di giorni di conservazione dei dati QoE prima dello svuotamento del database. Questo valore viene ignorato se EnablePurging è impostato su False.

Deve essere un valore compreso tra 1 e 2562.

PurgeHourOfDay

Facoltativo

UInt32

L'ora del giorno in cui saranno eliminati i record QoE che hanno superato il numero di giorni specificato in KeepQoEDataForDays.

Deve essere un valore compreso tra 0 e 23, che rappresenta l'ora del giorno. Ad esempio, 0 corrisponde a mezzanotte, 13 alle 13.00.

Force

Facoltativo

Parametro opzionale

Elimina qualsiasi richiesta di conferma che, in caso contrario, sarebbe visualizzata prima di effettuare le modifiche.

WhatIf

Facoltativo

Parametro opzionale

Descrive ciò che accadrebbe se si eseguisse il comando senza eseguirlo realmente.

Confirm

Facoltativo

Parametro opzionale

Viene visualizzata una richiesta di conferma prima di eseguire il comando.

Tipi di input

Oggetto Microsoft.Rtc.Management.WritableConfig.Settings.QoE.QoESettings. Consente di accettare l'input da pipeline di oggetti configurazione QoE.

Tipi restituiti

Set-CsQoEConfiguration non restituisce un valore o un oggetto. Il cmdlet, invece, consente di configurare le istanze dell'oggetto Microsoft.Rtc.Management.WriteableConfig.Settings.QoE.QoESettings.

Esempio

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

Set-CsQoEConfiguration -Identity site:Redmond -EnableQoE $False

Con il comando nell'esempio 1 viene utilizzato il cmdlet Set-CsQoEConfiguration per modificare le impostazioni per la qualità percepita dagli utenti per il sito Redmond (-Identity site:Redmond). Le nuove impostazioni disattivano QoE impostando il parametro EnableQoE su False.

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

Set-CsQoEConfiguration -Identity site:Dublin -KeepQoEDataForDays 45 -PurgeHourOfDay 4

Con questo comando vengono modificate le impostazioni QoE applicate al sito Dublin. Con questo esempio il parametro KeepQoEDataForDays viene impostato su 45, quindi i dati QoE saranno eliminati dal database dopo 45 giorni. Inoltre, il parametro PurgeHourOfDay è stato impostato su 4, quindi i dati più vecchi di 45 giorni appena specificati saranno eliminati alle 4.00.

Nota: Se QoE e la registrazione dei dettagli delle chiamate (CDR) sono stati abilitati, per motivi di prestazioni si consiglia di verificare che l'impostazione PurgeHourOfDay sia diversa per QoE e per CDR.