Get-CsHealthMonitoringConfiguration
Dernière rubrique modifiée : 2012-03-23
Retourne des informations sur les paramètres de configuration d’analyse d’intégrité utilisés dans l’organisation. 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 de test requis.
Syntaxe
Get-CsHealthMonitoringConfiguration [-Identity <XdsGlobalRelativeIdentity>] [-LocalStore <SwitchParameter>]
Get-CsHealthMonitoringConfiguration [-Filter <String>] [-LocalStore <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 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).
Vous pouvez exécuter les transactions synthétiques de deux manières. De nombreux administrateurs utiliseront les cmdlets CsHealthMonitoringConfiguration pour configurer des comptes de test pour chacun de leurs pools de serveurs d’inscriptions ou de directeurs. 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.) Lorsque les comptes de test ont été 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. En fait, la transaction synthétique utilise automatiquement les comptes de test préconfigurés lors de l’exécution de ses vérifications.
Les administrateurs peuvent également exécuter une transaction synthétique en utilisant des comptes d’utilisateur réels. Si, par exemple, deux utilisateurs ne peuvent pas échanger des messages instantanés, un administrateur peut exécuter une transaction synthétique en utilisant les deux comptes d’utilisateur (et non pas une paire 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 Get-CsHealthMonitoringConfiguration permet de retourner des informations concernant les paramètres de configuration d’analyse d’intégrité utilisés dans 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 Get-CsHealthMonitoringConfiguration : 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-CsHealthMonitoringConfiguration"}
Paramètres
Paramètre | Obligatoire | Type | Description |
---|---|---|---|
Identity |
Facultatif |
XdsIdentity |
Nom de domaine complet (FQDN) du pool où les paramètres de configuration d’analyse d’intégrité ont été définis. Par exemple : -Identity atl-cs-001.litwareinc.com. Si vous ne définissez pas ce paramètre, Get-CsHealthMonitoringConfiguration retourne des informations sur tous les paramètres de configuration d’analyse d’intégrité actuellement utilisés. |
Filter |
Facultatif |
Chaîne |
Permet d’utiliser des caractères génériques pour définir les paramètres de configuration d’analyse d’intégrité à extraire. L’exemple ci-dessous retourne tous les paramètres définis pour le domaine litwareinc.com : -Filter "*.litwareinc.com". |
LocalStore |
Facultatif |
Paramètre de commutateur |
Extrait les données de configuration d’analyse d’intégrité depuis le réplica local du magasin central de gestion et non directement du magasin central de gestion. |
Types d’entrées
Aucun. Get-CsHealthMonitoringConfiguration n’accepte pas la saisie de données transmises via le pipeline.
Types de retours
Get-CsHealthMonitoringConfiguration retourne les instances de l’objet Microsoft.Rtc.Management.WritableConfig.Settings.HealthMonitoring.HealthMonitoringSettings.
Exemple
-------------------------- Exemple 1 --------------------------
Get-CsHealthMonitoringConfiguration
La commande précédente retourne tous les paramètres de configuration d’analyse d’intégrité actuellement utilisés dans l’organisation.
-------------------------- Exemple 2 --------------------------
Get-CsHealthMonitoringConfiguration -Identity atl-cs-001.litwareinc.com
La commande de l’exemple 2 retourne une seule collection de paramètres de configuration d’analyse d’intégrité : il s’agit des paramètres ayant l’identité atl-cs-001.litwareinc.com.
-------------------------- Exemple 3 --------------------------
Get-CsHealthMonitoringConfiguration -Filter *.litwareinc.com
L’exemple 3 retourne tous les paramètres de configuration d’analyse d’intégrité créés pour le domaine litwareinc.com. Pour ce faire, la cmdlet Get-CsHealthMonitoringConfiguration est appelée avec le paramètre Filter. La valeur de filtre *.litwareinc.com permet de retourner uniquement les paramètres dont l’identité se termine par la valeur de type chaîne « .litwareinc.com ».
-------------------------- Exemple 4 --------------------------
Get-CsHealthMonitoringConfiguration | Where-Object {$_.FirstTestUserSipUri -eq "sip:kenmyer@litwareinc.com" -or $_.SecondTestUserSipUri -eq " sip:kenmyer@litwareinc.com"}
La commande de l’exemple 4 retourne tous les paramètres de configuration d’analyse d’intégrité qui contiennent l’utilisateur ayant l’adresse SIP sip:kenmyer@litwareinc.com correspondant à l’un des utilisateurs du test. Pour exécuter cette tâche, la commande appelle d’abord Get-CsHealthMonitoringConfiguration sans autres paramètres, ce qui permet de retourner la collection de 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 "sip:kenmyer@litwareinc.com" ou dont la valeur de la propriété SecondTestUserSipUri est "sip:kenmyer@litwareinc.com". Vous obtenez ainsi une collection de paramètres où l’adresse SIP de Ken Myer est utilisée pour le premier ou le second utilisateur du test.
Voir aussi
Autres ressources
New-CsHealthMonitoringConfiguration
Remove-CsHealthMonitoringConfiguration
Set-CsHealthMonitoringConfiguration