Test-CsDialInConferencing
Dernière rubrique modifiée : 2012-03-25
Test-CsDialInConferencing vérifie si un utilisateur peut participer à une session de conférence rendez-vous.
Syntaxe
Test-CsDialInConferencing -TargetFqdn <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>] [-UserSipAddress <String>]
Test-CsDialInConferencing [-TargetFqdn <String>] -UserCredential <PSCredential> -UserSipAddress <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>]
Description détaillée
Test-CsDialInConferencing est un exemple de « transaction synthétique » dans Microsoft Lync Server 2010. Les transactions synthétiques utilisées dans 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 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 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 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 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-CsDialInConferencing essaie de connecter un utilisateur de test au système. (Si vous utilisez des utilisateurs de test, Test-CsDialInConferencing se servira du premier compte de test configuré pour ce pool). Si l’ouverture de session réussit, la cmdlet utilise alors les informations d’identification et les autorisations de l’utilisateur pour essayer les numéros disponibles d’accès à la conférence rendez-vous. Le succès ou l’échec de chaque tentative de connexion est consigné, puis l’utilisateur de test est déconnecté de Lync Server.
Test-CsDialInConferencing vérifie uniquement que les connexions appropriées peuvent être effectuées. La cmdlet ne passe pas réellement d’appels téléphoniques ou ne crée pas de conférences rendez-vous que d’autres utilisateurs peuvent rejoindre.
Personnes autorisées à exécuter cette cmdlet : Par défaut, les membres des groupes qui suivent sont autorisés à exécuter localement la cmdlet Test-CsDialInConferencing : 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 "Test-CsDialInConferencing"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
TargetFqdn |
Obligatoire |
Chaîne |
Nom de domaine complet (FQDN) du pool à tester. |
UserCredential |
Obligatoire |
Objet Credential PS |
Objet d’identification du compte utilisateur à tester. La valeur transmise à UserCredential 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 saisir le mot de passe de l’utilisateur lors de l’exécution de cette commande. Ce paramètre n’est pas requis si vous exécutez le test d’après les paramètres de configuration d’analyse d’intégrité. |
UserSipAddress |
Obligatoire |
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 requis si vous exécutez le test d’après les paramètres de configuration d’analyse d’intégrité. |
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. |
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. |
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. |
Types d’entrées
Aucun. Test-CsDialInConferencing n’accepte pas la saisie de données transmises via le pipeline.
Types de retours
Test-CsDialInConferencing retourne une instance de l’objet Microsoft.Rtc.SyntheticTransactions.TaskOutput.
Exemple
-------------------------- Exemple 1 --------------------------
Test-CsDialInConferencing -TargetFqdn atl-cs-001.litwareinc.com
L’exemple précédent vérifie qu’un utilisateur de test préconfiguré peut participer à une conférence rendez-vous sur le 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 tel est le cas, la commande détermine si le premier utilisateur de test peut se connecter à Lync Server.
Si les utilisateurs de test n’ont pas été définis, la commande échoue car elle ne sait pas sous quel utilisateur se connecter. Si vous n’avez pas défini un utilisateur de test pour le pool, vous devez inclure le paramètre UserCredential et les informations d’identification de l’utilisateur que la commande doit utiliser pour se connecter.
-------------------------- Exemple 2 --------------------------
$cred1 = Get-Credential "litwareinc\pilar"
Test-CsDialInConferencing -TargetFqdn atl-cs-001.litwareinc.com -UserSipAddress "sip:pilar@litwareinc.com" -UserCredential $cred1
Les commandes présentées dans l’exemple 2 vérifient la capacité d’un utilisateur spécifique (litwareinc\pilar) à participer à une conférence rendez-vous sur le pool atl-cs-001.litwareinc.com. 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 vérifie ensuite si l’utilisateur Pilar Ackerman peut se connecter au pool atl-cs-001.litwareinc.com et participer ensuite à une conférence rendez-vous. Afin d’effectuer cette tâche, Test-CsDialInConferencing 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).