Partager via

  • Article

New-CsQoEConfiguration

 

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

Crée une nouvelle collection de paramètres QoE (qualité du service).

Syntaxe

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

Description détaillée

Les indicateurs QoE mesure la qualité des appels audio et vidéo dans votre organisation, y compris les éléments comme le nombre de paquets perdus, le bruit de fond et les « gigues » (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 créer des paramètres qui configurent le contrôle QoE au niveau du site. (Les paramètres au niveau du site global existent par défaut et ne peuvent pas être supprimés.)

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 New-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 "New-CsQoEConfiguration"}

Paramètres

Paramètre Obligatoire Type Description

Identity

Obligatoire

XdsIdentity

Site auquel les nouveaux paramètres sont appliqués. Ce site doit être saisi au format <site name>, où <site name> est le nom du site dans votre déploiement Lync Server 2010.

EnableExternalConsumer

Facultatif

Booléen

Spécifie si un client externe est autorisé à recevoir des rapports QoE.

Valeur par défaut : False

EnablePurging

Facultatif

Booléen

Spécifie si les rapports seront purgés une fois que la durée définie dans la propriété KeepQoEDataForDays a expiré.

Valeur par défaut : True

EnableQoE

Facultatif

Booléen

Spécifie si les enregistrements QoE seront collectés et enregistrés dans la base de données d’analyse.

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

Valeur par défaut : True

ExternalConsumerIssuedCertId

Facultatif

IssuedCertId

L’identificateur de certificat qui permet d’avoir accès au service Web du consommateur externe.

ExternalConsumerName

Facultatif

Chaîne

Le nom convivial du consommateur externe du rapport QoE.

ExternalConsumerURL

Facultatif

Chaîne

L’ URL du consommateur externe à qui les rapports QoE seront postés.

KeepQoEDataForDays

Facultatif

UInt32

Le nombre de jours pendant lesquels les données QoE seront enregistrées avant d’être purgées de la base de données. La valeur est ignorée si EnablePurging est configuré sur False.

Doit être une valeur entre et 1 et 2562.

Valeur par défaut : 60

PurgeHourOfDay

Facultatif

UInt32

L’heure de la journée à 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 de 0 à 23, ce qui représente l’heure de la journée. Par exemple, 0 correspond à minuit et 13 à 13 h 00. Valeur par défaut : 1

Force

Facultatif

Paramètre de commutateur

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

InMemory

Facultatif

Paramètre de commutateur

Crée une référence d’objet sans valider l’objet comme une modification définitive. Si vous affectez à une variable la sortie de cette cmdlet appelée avec ce paramètre, vous pouvez apporter des modifications aux propriétés de la référence d’objet, puis les valider en appelant la cmdlet Set- correspondante.

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

Aucun.

Types de retours

Crée un objet de type Microsoft.Rtc.Management.WritableConfig.Settings.QoE.QoESettings.

Exemple

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

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

La commande de l’exemple 1 utilise la cmdlet New-CsQoEConfiguration pour créer un nouvel ensemble de paramètres de qualité de service avec l’identité site:Redmond. En plus de l’identité site:Redmond, la propriété EnabbleQoE des nouveaux paramètres est également configurée avec la valeur False. Puisque les paramètres de site ont priorité sur les paramètres globaux, cela signifie que le contrôle QoE sera désactivé pour le site Redmond, que QoE ait été désactivé ou pas dans l’étendue globale.

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

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

Cette commande crée des paramètres QoE qui s’appliquent au site Dublin. Dans cet exemple, nous avons configuré le paramètre KeepQoEDataForDays sur 30, de sorte que les données soient purgées de la base de données tous les 30 jours plutôt qu’après la période par défaut de 60 jours. En outre, nous avons configuré le paramètre PurgeHourOfDay sur 4, ce qui signifie que toutes les données antérieures à 30 jours que nous venons de spécifier seront purgées à 4 h 00.

Remarque : Si vous avez activé QoE et l’enregistrement des détails des appels, il est préférable, pour des raisons de performance, de vous assurer que le paramètre PurgeHourOfDay est différent pour le QoE et pour l’enregistrement des détails des appels.