Test-CsRegistration
Dernière rubrique modifiée : 2012-03-26
Teste la capacité d’un utilisateur à se connecter à Microsoft Lync Server 2010. Test-CsRegistration est une « transaction synthétique » : une simulation des activités courantes de Lync Server 2010 utilisée pour l’analyse de l’intégrité et des performances.
Syntaxe
Test-CsRegistration -TargetFqdn <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>] [-UserSipAddress <String>]
Test-CsRegistration [-TargetFqdn <String>] -UserCredential <PSCredential> -UserSipAddress <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>]
Description détaillée
Test-CsRegistration est un exemple de « transaction synthétique » Lync Server. Les transactions synthétiques utilisées dans Lync Server 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 sont généralement conduites de deux manières différentes. De nombreux administrateurs utiliseront les cmdlets CsHealthMonitoringConfiguration pour configurer des utilisateurs de test pour chacun de leurs pools de serveurs d’inscriptions. Ces utilisateurs 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.) Avec des utilisateurs de test configurés pour un pool, les administrateurs peuvent exécuter simplement 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.
Les administrateurs peuvent également exécuter une transaction synthétique à l’aide de comptes de vrais utilisateurs. Ainsi, si deux utilisateurs ne peuvent pas échanger de messages instantanés, l’administrateur peut exécuter une transaction synthétique à l’aide des deux comptes d’utilisateur en question (et non à l’aide de comptes de test) afin de diagnostiquer et résoudre le problème. Si vous décidez d’effectuer une transaction synthétique à l’aide de comptes d’utilisateurs réels, vous devrez saisir les noms des utilisateurs et les mots de passe de chacun d’eux.
La cmdlet Test-CsRegistration permet de vérifier que les utilisateurs de votre organisation parviennent à se connecter à Lync Server. Afin d’effectuer cette vérification, Test-CsRegistration nécessite un compte de test unique. Si vous avez défini des utilisateurs de test pour le pool concerné, vous n’avez pas besoin de spécifier de compte. Test-CsRegistration utilise en effet automatiquement le premier compte de test affecté au pool. (Pour plus d’informations, consultez la rubrique d’aide New-CsHealthMonitoringConfiguration.) Vous pouvez également effectuer le test à l’aide d’un compte qui n’a pas été affecté au pool. Ainsi, vous exécutez des tests même si n’avez pas configuré d’utilisateurs de test. Vous pouvez également tester la capacité d’un utilisateur spécifique à se connecter à Lync Server. (Si vous choisissez d’utiliser cette approche, vous devrez fournir le nom et le mot de passe de l’utilisateur du compte à tester.)
Quand vous exécutez Test-CsRegistration, la cmdlet tente de connecter l’utilisateur de test à Lync Server. Si l’opération réussit, elle déconnecte alors l’utilisateur du système. Ces actions sont effectuées sans interaction des utilisateurs et sans affecter ces derniers. Supposons, par exemple, que le compte de test sip:kenmyer@litwareinc.com correspond à un utilisateur bien réel possédant effectivement un compte Lync Server. Dans ces cas, le test sera effectué sans perturbation pour le vrai utilisateur Ken Myer. Lorsque le compte de test de Ken Myer se déconnecte du système, la personne Ken Myer reste connectée.
L’ajout du paramètre Verbose permet d’obtenir un compte détaillé de toutes les actions effectuées par Test-CsRegistration afin de mener à bien le test.
Personnes autorisées à exécuter cette cmdlet : 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 "Test-CsRegistration"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
TargetFqdn |
Obligatoire |
Chaîne |
Nom de domaine complet (FQDN) du pool à tester. |
OutVerboseVariable |
Facultatif |
Chaîne |
Lorsqu’elle est définie, la sortie détaillée de l’exécution de la cmdlet est stockée dans la variable spécifiée. Par exemple, pour stocker une sortie dans une variable nommée $TestOutput, utilisez la syntaxe suivante : -OutVerboseVariable TestOutput N’utilisez pas le caractère $ pour indiquer le nom de la variable. |
RegistrarPort |
Facultatif |
Entier |
Port SIP utilisé par le service Serveur d’inscriptions. Ce paramètre n’est pas obligatoire si le serveur d’inscriptions utilise le port par défaut 5061. |
UserCredential |
Facultatif |
Objet Credential PS |
Objet d’identification du compte utilisateur à tester. La valeur transmise à UserCredential doit être une référence d’objet obtenue par l’utilisation de la cmdlet Get-Credential. Par exemple, ce code retourne un objet d’identification pour l’utilisateur litwareinc\kenmyer et stocke cet objet dans une variable nommée $x: $x = Get-Credential "litwareinc\kenmyer" Vous devez fournir un mot de passe utilisateur lors de l’exécution de cette commande. Ce paramètre n’est pas obligatoire si vous exécutez le test d’après les paramètres de configuration d’analyse d’intégrité du pool. |
UserSipAddress |
Facultatif |
Adresse SIP |
Adresse SIP du compte d’utilisateur à tester, par exemple : -UserSipAddress "sip:kenmyer@litwareinc.com". Le paramètre UserSipAddress doit se référer au même compte d’utilisateur que UserCredential. Ce paramètre n’est pas obligatoire si vous exécutez le test d’après les paramètres de configuration d’analyse d’intégrité du pool. |
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. |
Verbose |
Facultatif |
Paramètre de commutateur |
Crée un rapport détaillé des activités à l’écran lors de l’exécution de la cmdlet. |
Types d’entrées
Aucun. Test-CsRegistration n’accepte pas la saisie de données transmises via le pipeline.
Types de retours
Test-CsRegistration retourne une instance de l’objet Microsoft.Rtc.SyntheticTransactions.TaskOutput.
Exemple
-------------------------- Exemple 1 --------------------------
Test-CsRegistration -TargetFqdn atl-cs-001.litwareinc.com
L’exemple ci-dessus teste le service Serveur d’inscriptions du pool atl-cs-001.litwareinc.com. Cette commande ne fonctionne que si des utilisateurs de test ont été définis pour le pool atl-cs-001.litwareinc.com. Si c’est le cas, la commande détermine si le premier utilisateur de test peut se connecter à Lync Server.
Si aucun utilisateur de test n’a pas été défini, la commande échoue car elle ne sait pas quel utilisateur employer pour la connexion. Si vous n’avez pas défini d’utilisateurs de test pour le pool, vous devez inclure le paramètre UserSipAddress et les informations d’identification de l’utilisateur que la commande doit utiliser pour la connexion.
-------------------------- Exemple 2 --------------------------
$cred1 = Get-Credential "litwareinc\pilar"
Test-CsRegistration -TargetFqdn atl-cs-001.litwareinc.com -UserCredential $cred1 -UserSipAddress "sip:pilar@litwareinc.com"
Les commandes illustrées dans l’exemple 2 testent la capacité d’un utilisateur spécifique (litwareinc\pilar) à se connecter à Lync Server. Pour ce faire, la première commande de l’exemple utilise la cmdlet Get-Credential pour créer un objet d’identification Windows PowerShell contenant le nom et le mot de passe de l’utilisateur Pilar Ackerman. (Le nom de connexion litwareinc\pilar ayant été inclus en tant que paramètre, la boîte de dialogue Demande d’informations d’identification Windows PowerShell qui s’affiche exige uniquement que l’administrateur entre le mot de passe relatif au compte Pilar Ackerman). L’objet d’identification qui en résulte est ensuite stocké dans une variable nommée $cred1.
La deuxième commande vérifie ensuite si cet utilisateur peut se connecter au pool atl-cs-001.litwareinc.com. Afin d’effectuer cette tâche, Test-CsRegistration est appelée avec trois paramètres : TargetFqdn (nom de domaine complet du pool de serveurs d’inscriptions), UserCredential (objet Windows PowerShell contenant les informations d’identification de Pilar Ackerman) et UserSipAddress (adresse SIP correspondant aux informations d’identification fournies).