Partager via

  • Article

Remove-CsHealthMonitoringConfiguration

 

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

Supprime une collection existante de paramètres de configuration de l’analyse d’intégrité. Ces paramètres permettent aux administrateurs d’effectuer des tests d’assurance qualité sans avoir à fournir les noms d’utilisateur et les mots de passe pour les comptes test requis.

Syntaxe

Remove-CsHealthMonitoringConfiguration -Identity <XdsGlobalRelativeIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Description détaillée

Les transactions synthétiques utilisées dans Microsoft Lync Server 2010 permettent de vérifier que les utilisateurs peuvent exécuter les tâches courantes, notamment pour se connecter au système, échanger des messages instantanés ou appeler un numéro de téléphone sur le réseau téléphonique commuté (PSTN). Ces tests peuvent être réalisés manuellement par un administrateur ou exécutés automatiquement par une application telle que Microsoft System Center Operations Manager (anciennement Microsoft Operations Manager).

Les transactions synthétiques peuvent être effectuées de deux manières différentes. De nombreux administrateurs utiliseront les cmdlets CsHealthMonitoringConfiguration pour configurer des comptes de test pour chacun de leurs pools de serveurs d’inscriptions. Ces comptes de test sont un groupe de deux utilisateurs préconfigurés pour être utilisés avec des transactions synthétiques. (En règle générale, il s’agit de comptes de test et non de comptes appartenant à de réels utilisateurs.) Quand ces comptes de test sont configurés pour un pool, les administrateurs peuvent exécuter une transaction synthétique dans ce pool sans spécifier les identités (et saisir les informations d’identification) des comptes d’utilisateurs impliqués dans le test. Au lieu de cela, la transaction synthétique utilise automatiquement les comptes test préconfigurés lorsqu’elle effectue la vérification.

Les administrateurs peuvent également exécuter une transaction synthétique à l’aide de comptes d’utilisateur réels. Par exemple, si deux utilisateurs ne parviennent pas à échanger des messages instantanés, un administrateur peut exécuter une transaction synthétique à l’aide des deux comptes d’utilisateur en question (par opposition à un groupe de comptes de test). Si vous décidez d’effectuer une transaction synthétique à l’aide de comptes d’utilisateurs réels, vous devrez saisir les informations d’identification de chaque utilisateur.

La cmdlet Remove-CsHealthMonitoringConfiguration vous permet de supprimer tout paramètre de configuration d’analyse d’intégrité en vue d’une utilisation au sein de votre organisation.

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-CsHealthMonitoringConfiguration : 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-CsHealthMonitoringConfiguration"}

Paramètres

Paramètre Obligatoire Type Description

Identity

Obligatoire

XdsIdentity

Nom de domaine complet (FQDN) du pool hébergeant les paramètres de configuration d’analyse d’intégrité à supprimer. Par exemple : -Identity atl-cs-001.litwareinc.com.

Force

Facultatif

Paramètre de commutateur

Supprime l’affichage de tous les messages d’erreur récupérable susceptibles d’apparaître lors de l’exécution de la commande.

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.HealthMonitoring.HealthMonitoringSettings. Remove-CsHealthMonitoringConfiguration accepte les instances transmises via le pipeline de l’objet de configuration d’analyse d’intégrité.

Types de retours

Aucun. En fait, Remove-CsHealthMonitoringConfiguration supprime les instances existantes de l’objet Microsoft.Rtc.Management.WritableConfig.Settings.HealthMonitoring.HealthMonitoringSettings.

Exemple

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

Remove-CsHealthMonitoringConfiguration -Identity atl-cs-001.litwareinc.com

La commande présentée dans l’exemple 1 supprime la collection de paramètres de configuration d’analyse d’intégrité dont la propriété Identity est atl-cs-001.litwareinc.com. Puisque les identités doivent être uniques, cette commande supprimera, au mieux, une collection unique de paramètres.

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

Get-CsHealthMonitoringConfiguration | Remove-CsHealthMonitoringConfiguration

L’exemple 2 supprime tous les paramètres de configuration d’analyse d’intégrité actuellement utilisés. Pour effectuer cette tâche, la commande appelle d’abord Get-CsHealthMonitoringConfiguration sans paramètres, ce qui retourne une collection de tous les paramètres de configuration d’analyse d’intégrité utilisés dans l’organisation. Cette collection est ensuite redirigée vers Remove-CsHealthMonitoringConfiguration qui supprime chaque élément dans la collection.

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

Get-CsHealthMonitoringConfiguration -Filter *.litwareinc.com  | Remove-CsHealthMonitoringConfiguration

La commande ci-dessus supprime tous les paramètres de configuration d’analyse d’intégrité créés pour le domaine litwareinc.com. Pour ce faire, Get-CsHealthMonitoringConfiguration est appelé avec le paramètre Filter. La valeur de filtre « *.litwareinc.com » permet de retourner uniquement les paramètres dont l’identité se termine pas la valeur de type chaîne « .litwareinc.com ». La collection filtrée est alors redirigée vers Remove-CsHealthMonitoringConfiguration qui supprime chaque élément dans la collection.

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

(Get-CsHealthMonitoringConfiguration | Where-Object {$_.FirstTestUserSipUri -eq "sip:kenmyer@litwareinc.com" -or $_.SecondTestUserSipUri -eq " sip:kenmyer@litwareinc.com"}) | Remove-CsHealthMonitoringConfiguration

La commande illustrée dans l’exemple 4 supprime tous les paramètres de configuration d’analyse d’intégrité qui incluent l’utilisateur avec l’adresse SIP sip:kenmyer@litwareinc.com comme l’un des utilisateurs test. Pour cela, la commande appelle d’abord Get-CsHealthMonitoringConfiguration sans aucun paramètre supplémentaire. Il en résulte une collection contenant tous les paramètres de configuration d’analyse d’intégrité actuellement utilisés dans l’organisation. Cette collection est ensuite redirigée vers la cmdlet Where-Object qui sélectionne uniquement les paramètres dont la valeur de la propriété FirstTestUserSipUri est (-eq) "sip:kenmyer@litwareinc.com" ou dont la valeur de la propriété SecondTestUserSipUri est "sip:kenmyer@litwareinc.com". À leur tour, ces paramètres sont redirigés vers Remove-CsHealthMonitoringConfiguration qui les supprime.