Partager via

  • Article

New-CsHealthMonitoringConfiguration

 

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

Crée une nouvelle collection de paramètres de configuration d’analyse d’intégrité à utiliser dans votre 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 test requis.

Syntaxe

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

New-CsHealthMonitoringConfiguration -FirstTestUserSipUri <String> -SecondTestUserSipUri <String> -TargetFqdn <String> [-Confirm [<SwitchParameter>]] [-FirstTestSamAccountName <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-SecondTestSamAccountName <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 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.) Lorsque 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 New-CsHealthMonitoringConfiguration vous permet de créer des paramètres de configuration d’analyse d’intégrité pour un pool de serveurs d’inscriptions ou de directeurs. Lorsque vous créez une collection de paramètres de configuration d’analyse d’intégrité, vous devez spécifier le nom de domaine complet (FQDN) du pool, ainsi que les adresses SIP des deux comptes qui serviront de comptes test du pool. (Cependant, vous n’avez pas besoin de fournir les mots de passe pour ces deux comptes test.) Notez que chaque pool ne peut héberger qu’une seule collection de paramètres de configuration d’analyse d’intégrité. Si vous essayez de créer une nouvelle collection de paramètres pour le pool atl-cs-001.litwareinc.com alors qu’un serveur d’inscriptions a déjà été attribué à ce pool, la commande échouera.

Lorsque vous exécutez New-CsHealthMonitoringConfiguration, vous pouvez recevoir un avertissement si certains de vos pools n’ont pas été affectés aux utilisateurs de test. Ceci inclut aussi bien les pools de directeurs que les pools Office Communications Server. Vous pouvez ignorer ces avertissements. Si vous le souhaitez, vous pouvez affecter les utilisateurs de test hébergés sur les autres pools à vos pools de directeurs. Cette action vous permet d’exécuter la cmdlet Test-CsRegistration sur le pool de directeurs. Toutefois, il est impossible d’affecter des utilisateurs de test aux pools Office Communications Server.

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

Paramètres

Paramètre Obligatoire Type Description

Identity

Facultatif

FQDN

Nom de domaine complet du pool auquel les paramètres de configuration d’analyse d’intégrité doivent être attribués (par exemple : -Identity atl-cs-001.litwareinc.com). La commande échouera si le pool spécifié héberge déjà une collection de paramètres de configuration d’analyse d’intégrité.

Le paramètre Identity est équivalent au paramètre TargetFqdn. Vous pouvez utiliser l’un ou l’autre de ces paramètres pour créer une collection de paramètres. Si vous n’utilisez aucun de ces deux paramètres, New-CsHealthMonitoringConfiguration vous invitera à entrer l’identité.

TargetFqdn

Facultatif

FQDN

Nom de domaine complet du pool auquel les paramètres de configuration d’analyse d’intégrité doivent être attribués (par exemple : -TargetFqdn atl-cs-001.litwareinc.com). La commande échouera si le pool spécifié héberge déjà une collection de paramètres de configuration d’analyse d’intégrité.

Le paramètre TargetFqdn est équivalent au paramètre Identity. Vous pouvez utiliser l’un ou l’autre de ces paramètres pour créer une collection de paramètres. Si vous n’utilisez aucun de ces deux paramètres, New-CsHealthMonitoringConfiguration vous invitera à entrer l’identité.

FirstTestSamAccountName

Facultatif

Chaîne

SamAccountName du premier utilisateur test. Le paramètre FirstTestSamAccountName doit être entré au format domaine\nom d’utilisateur, par 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. Le paramètre SecondTestSamAccountName doit être entré au format domaine\nom d’utilisateur, par 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 : -SecondTestUserSipUri "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.

InMemory

Facultatif

Paramètre de commutateur

Crée une référence d’objet sans valider l’objet comme une modification définitive. Si vous affectez à une variable la sortie de cette cmdlet appelée avec ce paramètre, vous pouvez apporter des modifications aux propriétés de la référence d’objet, puis les valider en appelant la cmdlet Set- correspondante.

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

Aucun. New-CsHealthMonitoringConfiguration n’accepte pas la saisie de données transmises via le pipeline.

Types de retours

New-CsHealthMonitoringConfiguration crée des instances de l’objet Microsoft.Rtc.Management.WritableConfig.Settings.HealthMonitoring.HealthMonitoringSettings.

Exemple

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

New-CsHealthMonitoringConfiguration -Identity atl-cs-001.litwareinc.com -FirstTestUserSipUri "sip:kenmyer@litwareinc.com" -SecondTestUserSipUri "sip:pilar@litwareinc.com"

La commande illustrée dans l’exemple 1 crée une collection de paramètres de configuration d’analyse d’intégrité pour le pool atl-cs-001.litwareinc.com. Ces nouveaux paramètres utiliseront les deux comptes de test préfigurés sip:kenmyer@litwareinc.com et sip:pilar@litwareinc.com.

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

$x = Get-CsService -Registrar | Select-Object PoolFqdn
foreach ($i in $x)
   {New-CsHealthMonitoringConfiguration -Identity $i.PoolFqdn -FirstTestUserSipUri "sip:kenmyer@litwareinc.com" -SecondTestUserSipUri "sip:pilar@litwareinc.com"}

L’exemple 2 crée une nouvelle collection de paramètres de configuration d’analyse d’intégrité pour tous les pools de serveurs d’inscriptions de l’organisation. Pour cela, la première commande de l’exemple utilise la cmdlet Get-Service et le paramètre Registrar pour retourner une collection de tous les pools de serveurs d’inscriptions. Cette collection est ensuite redirigée vers la cmdlet Select-Object qui sélectionne uniquement la propriété PoolFqdn. (Cette propriété retourne le nom de domaine complet du pool de serveurs d’inscriptions.) Ces noms de domaines sont stockées dans la variable $x.

Dans la seconde commande, une boucle foreach est créée pour analyser chaque nom de domaine complet du pool de serveurs d’inscriptions. La cmdlet New-CsHealthMonitoringConfiguration est appelée pour chaque nom de domaine complet afin de créer une collection de paramètres de configuration, avec le nom complet stocké dans la variable $x utilisée comme identité pour la nouvelle collection. Chaque collection se voit également attribuer les deux mêmes comptes de test : sip:kenmyer@litwareinc.com et sip:pilar@litwareinc.com.