Remove-CsQoEConfiguration
Dernière rubrique modifiée : 2012-03-27
Supprime une collection de paramètres de qualité de l’expérience (QoE, Quality of Experience).
Syntaxe
Remove-CsQoEConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Description détaillée
Les mesures QoE assurent le suivi de la qualité des appels audio et vidéo passés au sein de votre organisation et portent, entre autres, sur des éléments tels que le nombre de paquets de réseau perdus, le bruit de fond et l’instabilité (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 supprimer les paramètres de configuration de la QoE au niveau de l’étendue Site. L’appel de cette cmdlet sur la configuration QoE globale entraîne la réinitialisation de toutes les propriétés aux valeurs par défaut.
Personnes autorisées à exécuter cette cmdlet : Par défaut, les membres des groupes qui suivent sont autorisés à exécuter localement la cmdlet Remove-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 "Remove-CsQoEConfiguration"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Identity |
Obligatoire |
XdsIdentity |
Identificateur unique des paramètres à supprimer. Les valeurs possibles sont global et site:<nom site>, où <nom site> correspond au nom du site de déploiement de Microsoft Lync Server 2010 avec les paramètres à supprimer. |
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
Cette cmdlet ne retourne ni valeur, ni objet. Elle supprime à la place les instances de l’objet Microsoft.Rtc.Management.WritableConfig.Settings.QoE.QoESettings.
Exemple
-------------------------- Exemple 1 --------------------------
Remove-CsQoEConfiguration -Identity site:Redmond
La commande ci-dessus utilise Remove-CsQoEConfiguration pour supprimer les paramètres QoE affectés au site Redmond. L’utilisation du paramètre Identity garantit que seuls les paramètres affectés à un site spécifié seront supprimés.
-------------------------- Exemple 2 --------------------------
Get-CsQoEConfiguration -Filter site:* | Remove-CsQoEConfiguration
La commande illustrée dans l’exemple 2 supprime tous les paramètres QoE assignés au niveau de l’étendue Site. Pou ce faire, la commande utilise d’abord Get-CsQoEConfiguration et le paramètre Filter pour récupérer les paramètres QoE appropriés ; la chaîne avec caractères génériques « site:* » garantit que seuls les paramètres dont l’identité commence par la valeur de chaîne site: sont retournés. La collection filtrée est ensuite redirigée vers Remove-CsQoEConfiguration, qui supprime tous les éléments de la collection.
-------------------------- Exemple 3 --------------------------
Get-CsQoEConfiguration | Where-Object {$_.KeepQoEDataForDays -lt 30} | Remove-CsQoEConfiguration
Dans l’exemple 3, tous les paramètres QoE où la propriété KeepQoEDataForDays est inférieure à 30 sont supprimés. Pour effectuer cette tâche, la commande appelle Get-CsQoEConfiguration sans paramètres afin de renvoyer une collection de tous les paramètres QoE actuellement utilisés dans l’organisation. Cette collection est ensuite redirigée vers la cmdlet Where-Object, qui sélectionne uniquement les paramètres dans lesquels la propriété KeepQoEDataForDays est inférieure à (-lt) 30 jours. Ensuite, la collection filtrée est redirigée vers Remove-CsQoEConfiguration, qui supprime chaque élément de cette collection.