Partager via

  • Article

Get-CsQoEConfiguration

 

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

Récupère une ou plusieurs collections de paramètres de qualité de l’expérience (QoE).

Syntaxe

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

Get-CsQoEConfiguration [-Filter <String>] [-LocalStore <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 récupérer les paramètres qui configurent la QoE au niveau de l’étendue globale ou au niveau de l’étendue 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 Get-CsQoEConfiguration : RTCUniversalUserAdmins, 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 "Get-CsQoEConfiguration"}

Paramètres

Paramètre Obligatoire Type Description

Identity

Facultatif

XdsIdentity

Identificateur unique des paramètres que vous souhaitez récupérer. 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.

Filter

Facultatif

Chaîne

Permet d’utiliser des caractères génériques afin de retourner une ou plusieurs collections de paramètres de configuration QoE. Pour retourner une collection de tous les paramètres configurés au niveau de l’étendue Site, utilisez cette syntaxe : -Filter site:*. Pour retourner une collection de tous les paramètres qui ont la valeur de chaîne « Western » dans leur identité (la seule propriété que vous pouvez filtrer), utilisez cette syntaxe : -Filter *Western*.

LocalStore

Facultatif

Paramètre de commutateur

Récupère les paramètres à partir du réplica local du magasin central de gestion.

Types d’entrées

Aucun.

Types de retours

Get-CsQoEConfiguration retourne des instances de l’objet Microsoft.Rtc.Management.WritableConfig.Settings.QoE.QoESettings.

Exemple

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

Get-CsQoEConfiguration

Cet exemple utilise Get-CsQoEConfiguration pour retourner une collection de tous les paramètres QoE configurés pour être utilisés dans votre organisation.

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

Get-CsQoEConfiguration -Identity site:Redmond

L’exemple 2 utilise le paramètre Identity afin que Get-CsQoEConfiguration retourne uniquement les paramètres QoE dont l’identité est site:Redmond.

-------------------------- Exemple 3 --------------------------

Get-CsQoEConfiguration -Filter site:*

Dans l’exemple 3, le paramètre Filter est utilisé pour retourner tous les paramètres QoE qui ont été configurés au niveau de l’étendue Site. Le caractère générique « site:* » retourne tous les paramètres QoE dont l’identité commence par la valeur de chaîne site:. Les paramètres qui répondent à ces critères sont ceux qui ont été configurés au niveau de l’étendue Site.

-------------------------- Exemple 4 --------------------------

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

L’exemple précédent retourne une collection de tous les paramètres QoE dont la propriété KeepQoEDataForDays est inférieure à 30 jours. Pour ce faire, la commande utilise d’abord Get-CsQoEConfiguration pour renvoyer une collection de tous les paramètres QoE configurés dans l’organisation. Cette collection est ensuite redirigée vers la cmdlet Where-Object qui applique un filtre limitant les données retournées aux paramètres dont la valeur de KeepQoEDataForDays est inférieure à 30 jours.