Partager via

  • Article

Set-CsHealthMonitoringConfiguration

 

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

Modifie 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

Set-CsHealthMonitoringConfiguration [-Identity <XdsGlobalRelativeIdentity>] [-Confirm [<SwitchParameter>]] [-FirstTestSamAccountName <String>] [-FirstTestUserSipUri <String>] [-Force <SwitchParameter>] [-SecondTestSamAccountName <String>] [-SecondTestUserSipUri <String>] [-WhatIf [<SwitchParameter>]]

Set-CsHealthMonitoringConfiguration [-Confirm [<SwitchParameter>]] [-FirstTestSamAccountName <String>] [-FirstTestUserSipUri <String>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-SecondTestSamAccountName <String>] [-SecondTestUserSipUri <String>] [-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 les 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.

Après avoir configuré les paramètres de configuration de l’analyse d’intégrité, vous pouvez les modifier à tout moment à l’aide de la cmdlet Set-CsHealthMonitoringConfiguration. Cette cmdlet vous permet de modifier les comptes de test configurés pour être utilisés avec un pool.

Personnes autorisées à exécuter cette cmdlet : Par défaut, les membres des groupes qui suivent sont autorisés à exécuter localement la cmdlet Set-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 "Set-CsHealthMonitoringConfiguration"}

Paramètres

Paramètre Obligatoire Type Description

Identity

Obligatoire

FQDN

Nom de domaine complet du pool auquel les paramètres de configuration de l’analyse d’intégrité à modifier ont été attribués. Par exemple : -Identity atl-cs-001.litwareinc.com.

Instance

Facultatif

Objet HealthMonitoringSettings

Permet de transmettre une référence à un objet à la cmdlet plutôt que de définir des valeurs de paramètre individuelles.

FirstTestSamAccountName

Facultatif

Chaîne

SamAccountName du premier utilisateur test. FirstTestSamAccountName doit être spécifié selon le format domaine\nom d’utilisateur. Exemple :

-FirstTestSamAccountName litwareinc\kenmyer

FirstTestUserSipUri

Facultatif

Adresse SIP

Adresse SIP du premier utilisateur test à configurer pour être utilisée par cette collection de paramètres d’analyse d’intégrité. Notez que l’adresse SIP doit inclure le préfixe sip:. Par exemple : -FirstTestUserSipUri "sip:kenmyer@litwareinc.com".

SecondTestSamAccountName

Facultatif

Chaîne

SamAccountName du second utilisateur test. SecondTestSamAccountName doit être spécifié selon le format domaine\nom d’utilisateur. Exemple :

-SecondTestSamAccountName litwareinc\pilar

SecondTestUserSipUri

Facultatif

Adresse SIP

Adresse SIP du second utilisateur test à configurer pour être utilisée par cette collection de paramètres d’analyse d’intégrité. Notez que l’adresse SIP doit inclure le préfixe sip:. Par exemple : -FirstTestUserSipUri "sip:pilar@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. Set-CsHealthMonitoringConfiguration accepte les instances transmises via le pipeline de l’objet de configuration de l’analyse d’intégrité.

Types de retours

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

Exemple

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

Set-CsHealthMonitoringConfiguration -Identity atl-cs-001.litwareinc.com -FirstTestUserSipUri "sip:kenmyer@litwareinc.com" -FirstTestSamAccountName "litwareinc\kenmyer"

La commande présentée dans l’exemple 1 configure le premier utilisateur test attribué aux paramètres de configuration de l’analyse d’intégrité pour le pool atl-cs-001.litwareinc.com. Dans cet exemple, l’adresse SIP du nouvel utilisateur test est définie sur sip:kenmyer@litwareinc.com ; SamAccountName pour cet utilisateur test est défini sur kenmyer.

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

Get-CsHealthMonitoringConfiguration | Set-CsHealthMonitoringConfiguration -FirstTestUserSipUri "sip:kenmyer@litwareinc.com" -FirstTestSamAccountName "litwareinc\kenmyer"

La commande ci-dessus est une variante de la commande illustrée dans l’exemple 1. Ici, toutefois, le même nouvel utilisateur test est attribué à chaque collection des paramètres de configuration de l’analyse d’intégrité utilisés dans l’organisation. Pour cela, la commande utilise d’abord Get-CsHealthMonitoringConfiguration pour retourner une collection de tous les paramètres de configuration de l’analyse d’intégrité. Cette collection est ensuite redirigée vers Set-CsHealthMonitoringConfiguration, qui attribue la même adresse SIP du premier utilisateur test et la même valeur SamAccountName à chaque élément de la collection.

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

Get-CsHealthMonitoringConfiguration | Where-Object {$_.FirstTestUserSipUri -eq "sip:pilar@litwareinc.com"} | Set-CsHealthMonitoringConfiguration -FirstTestUserSipUri "sip:kenmyer@litwareinc.com" -FirstTestSamAccountName "litwareinc\kenmyer"

L’exemple 3 explique comment effectuer une opération de recherche/remplacement pour le premier utilisateur test attribué à une collection de paramètres de configuration de l’analyse d’intégrité ; ici, l’utilisateur dont l’adresse SIP est sip:pilar@litwareinc.com est remplacé dès qu’il apparaît en tant que premier utilisateur test dans une collection.

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 de l’analyse d’intégrité actuellement utilisés dans l’organisation. Cette collection est alors redirigée vers la cmdlet Where-Object qui sélectionne uniquement les éléments dans lesquels la propriété FirstTestUserSipUri est égale à (-eq) sip:pilar@litwareinc.com. Cette collection filtrée est à son tour redirigée vers Set-CsHealthMonitoringConfiguration, qui prend chaque élément de la collection et définit la valeur de la propriété FirstTestUserSipUri sur sip:kenmyer@litwareinc.com et la valeur de la propriété FirstTestSamAccountName sur kenmyer.