Test-CsAVConference
Dernière rubrique modifiée : 2012-03-26
Teste l’aptitude de deux utilisateurs à prendre part à une conférence audio/vidéo (A/V).
Syntaxe
Test-CsAVConference -TargetFqdn <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-ReceiverSipAddress <String>] [-RegistrarPort <Nullable>] [-SenderSipAddress <String>]
Test-CsAVConference [-TargetFqdn <String>] -ReceiverCredential <PSCredential> -ReceiverSipAddress <String> -SenderCredential <PSCredential> -SenderSipAddress <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>]
Description détaillée
Test-CsAVConference est un exemple de « transaction synthétique ». 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 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. 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 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 des comptes d’utilisateurs 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 de deux comptes d’utilisateurs (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.
La cmdlet Test-CsAVConference vérifie si deux utilisateurs de test peuvent établir une conférence audio/vidéo (A/V). Quand la cmdlet est exécutée, les deux utilisateurs sont connectés au système. Après la connexion, le premier utilisateur crée une conférence audio/vidéo et attend que le second utilisateur se joigne à cette conférence. Après un bref échange de données, la conférence est supprimée et les deux utilisateurs de test sont déconnectés.
En réalité, Test-CsAVConference n’établit pas de conférence audio/vidéo entre deux utilisateurs de test. La cmdlet vérifie en fait que les deux utilisateurs parviennent à établir les connexions nécessaires au déroulement de la conférence A/V.
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-CsAVConference"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
TargetFqdn |
Obligatoire |
Chaîne |
Nom de domaine complet (FQDN) du pool à tester. |
ReceiverCredential |
Facultatif |
Objet Credential PS |
Objet d’identification utilisateur du premier des deux comptes d’utilisateurs à tester. La valeur transmise à ReceiverCredential 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 fournir un mot de passe utilisateur lors de l’exécution de cette commande. Les informations d’identification du destinataire ne sont pas nécessaires si vous exécutez le test d’après les paramètres de configuration d’analyse d’intégrité du pool. |
ReceiverSipAddress |
Facultatif |
Adresse SIP |
Adresse SIP du premier des deux comptes d’utilisateur à tester. Par exemple : -ReceiverSipAddress "sip:pilar@litwareinc.com". Le paramètre ReceiverSipAddress doit se référer au même compte d’utilisateur que ReceiverCredential. 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. |
SenderCredential |
Facultatif |
Objet Credential PS |
Objet d’identification du compte d’utilisateur du deuxième compte d’utilisateur à tester. La valeur transmise à SenderCredential 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\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. Les informations d’identification de l’expéditeur ne sont pas nécessaires si vous exécutez le test d’après les paramètres de configuration d’analyse d’intégrité du pool. |
SenderSipAddress |
Facultatif |
Adresse SIP |
Adresse SIP du deuxième compte d’utilisateur à tester. Par exemple : -SenderSipAddress "sip:kenmyer@litwareinc.com". Le paramètre SenderSIPAddress doit se référer au même compte d’utilisateur que SenderCredential. 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. |
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 |
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.
Types de retours
Test-CsAVConference retourne une instance de l’objet Microsoft.Rtc.SyntheticTransactions.TaskOutput.
Exemple
-------------------------- Exemple 1 --------------------------
Test-CsAVConference -TargetFqdn atl-cs-001.litwareinc.com
La commande ci-dessus vérifie si une paire d’utilisateurs de test préconfigurés peut se connecter au pool atl-cs-001.litwareinc.com et participer à une conférence audio/vidéo. 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 les deux utilisateurs peuvent se connecter au système. Si oui, le premier utilisateur de test crée une conférence audio/vidéo et invite le second utilisateur à s’y joindre. La cmdlet vérifie ensuite si les deux utilisateurs de test peuvent établir une connexion.
Si aucun utilisateur de test n’a é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 SenderSipAddress et ReceiverSipAddress, ainsi que les informations d’identification correspondantes pour les utilisateurs intervenant dans cet échange de messages instantanés. Test-CsAVConference effectue 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-CsAVConference -TargetFqdn atl-cs-001.litwareinc.com -SenderSipAddress "sip:pilar@litwareinc.com" -SenderCredential $cred1 -ReceiverSipAddress "sip:kenmyer@litwareinc.com" -ReceiverCredential $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 2010 puis à participer à une conférence A/V. 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 effectue la même action, en retournant cette fois un objet d’identification pour le compte de Ken Myer.
Avec ces deux objets d’identification, la troisième commande de l’exemple détermine si les deux utilisateurs peuvent ou non se connecter à Lync Server 2010 et participer à une conférence A/V. Afin d’effectuer cette tâche, la cmdlet Test-CsAVConference est appelée avec les paramètres suivants : TargetFqdn (nom de domaine complet du pool de serveurs d’inscriptions) ; SenderSipAddress (adresse SIP du premier utilisateur de test) ; SenderCredential (objet Windows PowerShell contenant les informations d’identification de cet utilisateur) ; ReceiverSipAddress (adresse SIP du second utilisateur de test) et ReceiverCredential (objet Windows PowerShell contenant les informations d’identification du second utilisateur).