Test-CsPresence
Dernière rubrique modifiée : 2012-03-26
Teste la capacité d’un utilisateur à se connecter à Microsoft Lync Server 2010, à publier ses informations de présence, et à souscrire à des informations de présence publiées par un deuxième utilisateur.
Syntaxe
Test-CsPresence -TargetFqdn <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-PublisherSipAddress <String>] [-RegistrarPort <Nullable>] [-SubscriberSipAddress <String>] [-SubscriberSipAddress <String>]
Test-CsPresence [-TargetFqdn <String>] -PublisherCredential <PSCredential> -PublisherSipAddress <String> -SubscriberCredential <PSCredential> -SubscriberSipAddress <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>] [-SubscriberSipAddress <String>]
Description détaillée
Test-CsPresence est un exemple de transaction synthétique de Lync Server 2010. Les transactions synthétiques utilisées dans Lync Server 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 sont généralement effectuées 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. En règle générale, il s’agit de comptes de test et non de comptes appartenant à de réels utilisateurs. Avec comptes d'utilisateurs 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 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’utilisateurs en question (par opposition à un groupe de comptes de test), et essayer de diagnostiquer et de 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.
Test-CsPresence est utilisé pour déterminer si une paire d’utilisateurs test peut se connecter à Lync Server, puis échanger des informations de présence. Pour ce faire, la cmdlet connecte d’abord les deux utilisateurs au système. Si les deux connexions aboutissent, le premier utilisateur test demande à recevoir les informations de présence du deuxième utilisateur. Le deuxième utilisateur publie ces informations et Test-CsPresence vérifie que les informations ont été correctement transmises au premier utilisateur. Une fois les informations de présence échangées, les deux utilisateurs test sont ensuite déconnectés de Lync Server.
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-CsPresence"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
TargetFqdn |
Obligatoire |
Chaîne |
Nom de domaine complet (FQDN) du pool à tester. |
PublisherCredential |
Obligatoire |
Objet Credential PS |
Objet d’identification du premier compte d’utilisateur à tester. La valeur transmise à PublisherCredential doit être une référence d’objet obtenue à l’aide de la cmdlet Get-Credential. Par exemple, ce code renvoie un objet d’identification de l’utilisateur litwareinc\kenmyer et le stocke dans une variable appelée $x : $x = Get-Credential "litwareinc\kenmyer" Vous devez saisir le mot de passe de l’utilisateur lors de l’exécution de cette commande. Les informations d’identification de l’éditeur ne sont pas nécessaires si vous exécutez le test d'après les paramètres de configuration de l’analyse d’intégrité du pool. |
PublisherSipAddress |
Obligatoire |
Adresse SIP |
Adresse SIP du premier des deux comptes d’utilisateur à tester. Par exemple : -PublisherSipAddress "sip:kenmyer@litwareinc.com". Le paramètre PublisherSipAddress doit faire référence au même compte d’utilisateur que PublisherCredential. L’adresse SIP 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. |
SubscriberCredential |
Obligatoire |
Objet Credential PS |
Objet d’identification utilisateur du deuxième compte d’utilisateur à tester. La valeur transmise à SubscriberCredential doit être une référence d’objet obtenue à l’aide de la cmdlet Get-Credential. Par exemple, ce code retourne un objet d’identification pour l’utilisateur litwareinc\pilar et le stocke dans une variable appelée $y : $y = Get-Credential "litwareinc\pilar" Vous devez saisir le mot de passe de l’utilisateur lors de l’exécution de cette commande. Les informations d’identification de l’abonné ne sont pas nécessaires si vous exécutez le test d'après les paramètres de configuration de l’analyse d’intégrité du pool. |
SubscriberSipAddress |
Obligatoire |
Adresse SIP |
Adresse SIP du deuxième compte d’utilisateur à tester. Par exemple : -SubscriberSipAddress "sip:pilar@litwareinc.com". Le paramètre SubscriberSipAddress doit faire référence au même compte d’utilisateur que SubscriberCredential. L’adresse SIP 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. |
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. |
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. |
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 |
Chaîne |
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-CsPresence n’accepte pas la saisie de données transmises via le pipeline.
Types de retours
Test-CsPresence renvoie une instance de l’objet Microsoft.Rtc.SyntheticTransactions.TaskOutput.
Exemple
-------------------------- Exemple 1 --------------------------
Test-CsPresence -TargetFqdn atl-cs-001.litwareinc.com
L’exemple précédent vérifie si une paire d’utilisateurs test préconfigurés peut se connecter au pool atl-cs-001.litwareinc.com. Une fois les utilisateurs test connectés, Test-CsPresence vérifie ensuite si les deux utilisateurs peuvent échanger des informations de présence. Cette commande ne fonctionne que si des utilisateurs de test ont été définis pour le pool atl-cs-001.litwareinc.com. Si tel est le cas, la commande détermine si le premier utilisateur test peut se connecter au système, puis vérifie s’il peut échanger des informations de présence avec le deuxième utilisateur test défini pour le pool.
Si un serveur d’inscriptions avancé n’a pas été défini, la commande échouera, car elle ignore quels utilisateurs employer lors de l’exécution du test. Si vous n’avez pas défini d’utilisateurs de test pour un pool, vous devez inclure les paramètres SubscriberSipAddress et PublisherSipAddress, ainsi que les informations d’identification correspondantes pour les utilisateurs faisant office d’abonnés aux données de présence et d’éditeurs des données de présence. Test-CsPresence effectuera ensuite ses vérifications à l’aide des deux utilisateurs spécifiés.
-------------------------- Exemple 2 --------------------------
$cred1 = Get-Credential "litwareinc\pilar"
$cred2 = Get-Credential "litwareinc\kenmyer"
Test-CsPresence -TargetFqdn atl-cs-001.litwareinc.com -SubscriberSipAddress "sip:pilar@litwareinc.com" -SubscriberCredential $cred1 -PublisherSipAddress "sip:kenmyer@litwareinc.com" -PublisherCredential $cred2
Les commandes illustrées dans l’exemple 2 testent la capacité d’une paire d’utilisateurs (litwareinc\pilar et litwareinc\kenmyer) à se connecter à Lync Server et à échanger des des informations de présence. 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 étant inclus comme paramètre, la boîte de dialogue Demande d’informations d’identification Windows PowerShell demande seulement à l’administrateur de saisir le mot de passe correspondant au compte de Pilar Ackerman.) L’objet d’identification résultant est ensuite stocké dans une variable appelée $cred1. La deuxième commande remplit la même fonction, en renvoyant cette fois un objet d’identification pour le compte Ken Myer.
Avec les deux objets d’identification en main, la troisième commande décrite dans l’exemple détermine si les deux utilisateurs peuvent ou non se connecter à Lync Server et échanger des informations de présence. Pour exécuter cette tâche, la cmdlet Test-CsPresence est appelée, avec les paramètres suivants : TargetFqdn (le nom de domaine complet du pool de serveurs d'inscriptions), SubscriberSipAddress (l'adresse SIP d'un utilisateur de test), SubscriberCredential (l'objet Windows PowerShell contenant les information d'identification de ce même utilisateur), PublisherSipAddress (l'adresse SIP de l'autre utilisateur de test) et PublisherCredential (l'objet Windows PowerShell contenant les informations d'identification de cet autre utilisateur).