Partager via

  • Article

Set-CsQoEConfiguration

 

Dernière rubrique modifiée : 2012-03-26

Modifie un ensemble existant de paramètres de qualité de l’expérience (QoE, Quality of Experience).

Syntaxe

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

Description détaillée

Les mesures QoE effectuent le suivi de la qualité des appels audio et vidéo dans votre organisation, y compris le nombre de paquets réseau perdus, le bruit de fond et le montant de « gigue » (différences de retard des paquets). Ces mesures sont stockées dans une base de données distincte des autres données (telles que les enregistrements des détails des appels), ce qui permet d’activer et de désactiver l’enregistrement QoE indépendamment de l’enregistrement des autres données. Utilisez cette cmdlet pour modifier les paramètres de configuration de la QoE au niveau global ou du site.

L’enregistrement QoE fait partie du rôle du serveur de surveillance. Par conséquent, un serveur de surveillance doit être déployé dans votre installation Microsoft Lync Server 2010 pour que l’enregistrement QoE prenne effet ou que des données QoE puissent être collectées.

Personnes autorisées à exécuter cette cmdlet : Par défaut, les membres des groupes qui suivent sont autorisés à exécuter localement la cmdlet Set-CsQoEConfiguration : RTCUniversalServerAdmins. Pour retourner une liste de tous les rôles RBAC (Contrôle d’accès basé sur un rôle) auxquels cette cmdlet a été affectée (y compris les rôles RBAC personnalisés créés par vos soins), exécutez la commande suivante à l’invite Windows PowerShell :

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

Paramètres

Paramètre Obligatoire Type Description

Identity

Facultatif

XdsIdentity

Identificateur unique des paramètres que vous souhaitez modifier. Les valeurs possibles sont « global » et « site:<nom du site> », où <nom du site> est le nom du site dans votre déploiement Lync Server 2010 auquel vous voulez appliquer les modifications.

Instance

Facultatif

QoESettings

Référence d’objet à un objet de configuration QoE. Cet objet doit être du type QoESettings et peut être extrait en appelant la cmdlet Get-CsQoEConfiguration.

EnableExternalConsumer

Facultatif

Booléen

Indique si un utilisateur externe peut recevoir des rapports de QoE.

EnablePurging

Facultatif

Booléen

Indique si les enregistrements seront purgés une fois la période définie dans la propriété KeepQoEDataForDays écoulée.

EnableQoE

Facultatif

Booléen

Indique si des enregistrements QoE seront collectés et enregistrés dans la base de données de surveillance.

Notez que même si EnableQoE est défini sur True, les données QoE ne seront pas collectées, à moins qu'un serveur de surveillance ait été déployé et associé avec un pool de serveurs d'inscriptions.

ExternalConsumerIssuedCertId

Facultatif

IssuedCertId

ID du certificat qui autorise l’accès au service Web des utilisateurs externes.

ExternalConsumerName

Facultatif

Chaîne

Nom convivial de l’utilisateur externe du rapport QoE.

ExternalConsumerURL

Facultatif

Chaîne

URL de l’utilisateur externe pour lequel les rapports QoE seront publiés.

KeepQoEDataForDays

Facultatif

UInt32

Nombre de jours pendant lesquels les données QoE seront stockées avant qu’elles ne soient purgées de la base de données. Cette valeur est ignorée si EnablePurging est défini sur False.

Doit être une valeur comprise entre 1 et 2562.

PurgeHourOfDay

Facultatif

UInt32

Heure du jour à laquelle les enregistrements QoE ayant dépassé le nombre de jours spécifiés dans la propriété KeepQoEDataForDays seront purgés.

Doit être une valeur comprise entre 0 et 23, représentant l’heure de la journée. Par exemple, 0 correspond à minuit et 13 à 13 h 00.

Force

Facultatif

Paramètre de commutateur

Supprime les invites de confirmation qui s’affichent avant d’effectuer des modifications.

WhatIf

Facultatif

Paramètre de commutateur

Décrit ce qui se passe si vous exécutez la commande sans l’exécuter réellement.

Confirm

Facultatif

Paramètre de commutateur

Vous demande confirmation avant d’exécuter la commande.

Types d’entrées

Objet Microsoft.Rtc.Management.WritableConfig.Settings.QoE.QoESettings. Accepte la saisie de données transmises via le pipeline pour les objets de configuration QoE.

Types de retours

Set-CsQoEConfiguration ne retourne ni valeur, ni objet. Au lieu de cela, la cmdlet configure les instances de l’objet Microsoft.Rtc.Management.WritableConfig.Settings.QoE.QoESettings.

Exemple

-------------------------- Exemple 1 --------------------------

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

La commande illustrée dans l’exemple 1 utilise la cmdlet Set-CsQoEConfiguration pour modifier les paramètres de qualité d’expérience pour le site de Redmond (-Identity site:Redmond). Les nouveaux paramètres désactivent la QoE en définissant le paramètre EnableQoE sur False.

-------------------------- Exemple 2 --------------------------

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

Cette commande modifie les paramètres de QoE qui s’appliquent au site de Dublin. Dans cet exemple, nous avons configuré le paramètre KeepQoEDataForDays sur 45. Les données QoE seront donc purgées de la base de données au bout de 45 jours. En outre, nous avons configuré le paramètre PurgeHourOfDay sur 4, ce qui signifie que toutes les données antérieures à 45 jours que nous venons de spécifier seront purgées à 4 h 00.

Remarque : si vous avez activé QoE et Enregistrements des détails des appels (CDR), il peut être utile de vérifier que le paramètre PurgeHourOfDay est différent pour QoE et CDR pour des performances optimales.