Condividi tramite

  • Articolo

New-CsQoEConfiguration

 

Ultima modifica dell'argomento: 2012-03-25

Consente di creare una nuova raccolta di impostazioni della qualità percepita dagli utenti (QoE).

Sintassi

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

Descrizione dettagliata

La metrica QoE consente di tenere traccia delle chiamate audio e video effettuate all'interno dell'organizzazione, inclusi dati quali il numero di pacchetti di rete persi, il rumore di fondo e l'instabilità (differenze nel ritardo dei pacchetti). Questa metrica viene archiviata in un database dedicato, diverso da quello degli altri dati (ad esempio, record dettagli chiamata) e ciò consente di abilitare e disabilitare la qualità percepita dagli utenti (QoE) indipendentemente dalla registrazione degli altri dati. Utilizzare questo cmdlet per creare le impostazioni di configurazione della qualità percepita dagli utenti (QoE) a livello di sito. Le impostazioni a livello globale sono presenti per impostazione predefinita e non possono essere rimosse.

La qualità percepita dagli utenti (QoE) fa parte del ruolo di Monitoring Server di conseguenza, è necessario distribuire Monitoring Server sull'installazione di Microsoft Lync Server 2010 per poter effettuare la registrazione della qualità percepita dagli utenti (QoE) o la raccolta dei dati QoE.

Utenti autorizzati a utilizzare questo cmdlet: per impostazione predefinita, il cmdlet New-CsQoEConfiguration può essere utilizzato localmente dai membri dei seguenti gruppi: RTCUniversalServerAdmins. Per ottenere un elenco di tutti i ruoli RBAC (controllo dell'accesso basato sui ruoli) a cui è stato assegnato questo cmdlet (inclusi eventuali ruoli RBAC personalizzati), utilizzare il seguente comando dal prompt di Windows PowerShell:

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

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Obbligatorio

XdsIdentity

Il sito a cui vengono applicate le nuove impostazioni. Il formato deve essere site:<nome sito>, in cui <nome sito> indica il nome del sito nella distribuzione di Lync Server 2010.

EnableExternalConsumer

Facoltativo

Booleano

Indica se un consumatore esterno è in grado di ricevere rapporti QoE.

Valore predefinito: False

EnablePurging

Facoltativo

Booleano

Indica se i record verranno cancellati dopo la scadenza del valore definito nella proprietà KeepQoEDataForDays.

Valore predefinito: True

EnableQoE

Facoltativo

Booleano

Indica se i record QoE verranno raccolti e salvati nel database di monitoraggio.

Si noti che anche se EnableQoE è impostato su True, i dati QoE non verranno raccolti a meno che non sia stato distribuito un Monitoring Server e associato ad un pool di registrazione.

Valore predefinito: True

ExternalConsumerIssuedCertId

Facoltativo

IssuedCertId

L'ID del certificato che consente l'accesso al servizio Web dei consumatori esterni.

ExternalConsumerName

Facoltativo

Stringa

Il nome descrittivo del consumatore esterno del report QoE.

ExternalConsumerURL

Facoltativo

Stringa

L'URL del consumatore esterno a cui verranno inviati i rapporti QoE.

KeepQoEDataForDays

Facoltativo

UInt32

Il numero di giorni in cui i dati QoE verranno archiviati prima di essere eliminati dal database. Questo valore viene ignorato se EnablePurging è impostato su False.

Deve essere un valore compreso tra 1 e 2562.

Valore predefinito: 60

PurgeHourOfDay

Facoltativo

UInt32

L'ora in cui verranno eliminati i record QoE che hanno superato il valore relativo al numero di giorni specificato nella proprietà KeepQoEDataForDays.

Deve essere un valore compreso tra 0 e 23. Ad esempio, 0 indica la mezzanotte e 14 indica le due del pomeriggio. Valore predefinito: 1

Force

Facoltativo

Parametro opzionale

Consente di evitare la visualizzazione delle richieste di conferma che altrimenti verrebbero visualizzate prima che vengano apportate le modifiche.

InMemory

Facoltativo

Parametro opzionale

Crea un riferimento a un oggetto senza eseguire realmente il commit dell'oggetto come modifica permanente. Se si assegna l'output del cmdlet chiamato con questo parametro a una variabile, è possibile apportare modifiche alle proprietà del riferimento all'oggetto e quindi eseguire il commit di queste modifiche chiamando il cmdlet Set- corrispondente.

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

Nessuno.

Tipi restituiti

Consente di creare un oggetto di tipo Microsoft.Rtc.Management.WritableConfig.Settings.QoE.QoESettings.

Esempio

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

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

Il comando nell'Esempio 1 utilizza il cmdlet New-CsQoEConfiguration per creare un nuovo gruppo di impostazioni della qualità percepita dagli utenti (QoE) con Identity site:Redmond. Oltre a Identity site:Redmond le nuove impostazioni hanno anche la proprietà EnableQoE impostata su False. Dal momento che le impostazioni del sito hanno la precedenza sulle impostazioni globali, QoE sarà disabilitato per il sito Redmond, indipendentemente dal fatto che QoE sia stata abilitato o meno nell'ambito globale.

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

New-CsQoEConfiguration -Identity site:Dublin -KeepQoEDataForDays 30 -PurgeHourOfDay 4

Questo comando consente di creare nuove impostazioni QoE che si applicano al sito Dublin. In questo esempio il parametro KeepQoEDataForDays è stato impostato su 30, in modo tale che i dati QoE verranno eliminati ogni 30 giorni piuttosto che ogni 60 giorni (valore predefinito). Inoltre, è stato impostato il parametro PurgeHourOfDay su 4. Ciò significa che tutti i dati creati più di 30 giorni prima verranno eliminati alle quattro di mattina.

Nota se sono stati abilitati QoE e la registrazione dettagli chiamata (CDR), per ragioni legate alle prestazioni è buona norma assicurarsi che l'impostazione PurgeHourOfDay di QoE sia diversa da quella di CDR.