Test-CsPhoneBootstrap
Dernière rubrique modifiée : 2012-03-26
Vérifie qu’un utilisateur peut se connecter à Microsoft Lync Server 2010 à l’aide d’un périphérique compatible Microsoft Lync 2010 Phone Edition.
Syntaxe
Test-CsPhoneBootstrap [-TargetFqdn <String>] -PhoneOrExt <String> -PIN <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>] [-TargetUri <String>] [-UserSipAddress <String>]
Description détaillée
Pour pouvoir se connecter à Lync Server 2010, les périphériques compatibles Lync 2010 Phone Edition doivent utiliser le protocole DHCP (Dynamic Host Configuration Protocol) afin de récupérer l’adresse d’un service d’inscriptions Lync Server ; ces périphériques doivent également fournir un numéro de téléphone valide, ainsi que le code confidentiel associé, pour que le système puisse les authentifier. On utilise le terme « amorçage » pour désigner ce processus. La cmdlet Test-CsPhoneBootstrap permet aux administrateurs de vérifier qu’un utilisateur donné est capable de se connecter au système à partir d’un périphérique compatible Lync 2010 Phone Edition en se servant du numéro de téléphone et du code confidentiel qui lui ont été attribués. (Aucun périphérique n’est réellement nécessaire pour l’exécution du test.)
Pour que la cmdlet Test-CsPhoneBootstrap puisse effectuer cette vérification, le pool de serveurs d’inscriptions qui héberge le compte d’utilisateur testé doit pouvoir être détecté avec DHCP. Pour déterminer si un serveur d’inscriptions peut être détecté de cette manière, utilisez la cmdlet Get-CsRegistrarConfiguration et vérifiez la valeur de la propriété EnableDHCPServer. Si cette propriété a la valeur False, vous devrez utiliser Set-CsRegistrarConfiguration pour définir la valeur de la propriété sur True et permettre de détecter le serveur d’inscriptions via DHCP. Vous pouvez également faire appel au serveur DHCP Enterprise et configurer les options spécifiques à 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-CsPhoneBootstrap"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
PhoneOrExt |
Obligatoire |
Chaîne |
Numéro de téléphone ou poste du compte d’utilisateur à tester. Par exemple : -PhoneOrExt "+14255551219". |
PIN |
Obligatoire |
Chaîne |
Code confidentiel du compte d’utilisateur testé. |
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. |
TargetFqdn |
Facultatif |
Chaîne |
Nom de domaine complet (FDQN) du pool de serveurs d’inscriptions dans lequel est hébergé le compte d’utilisateur à tester. Si ce nom n’est pas spécifié, la détection DHCP permettra de localiser le pool de serveurs d’inscriptions. |
TargetUri |
Facultatif |
Chaîne |
URL du service de mise en service des certificats. Si ce paramètre n’est pas inclus, la détection DHCP sera utilisée pour localiser l’URI cible. |
UserSipAddress |
Facultatif |
Chaîne |
Adresse SIP du compte d’utilisateur utilisé dans le texte, par exemple : -UserSipAddress "sip:kenmyer@litwareinc.com". Le paramètre UserSIPAddress doit référencer le numéro de téléphone et le code confidentiel fournis ; le test échouera si le numéro de téléphone et le code confidentiel inclus n’appartiennent pas à l’utilisateur spécifié par le paramètre UserSipAddress. Notez que l’adresse SIP doit inclure le préfixe « sip: » . |
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 |
GUID |
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-CsPhoneBootstrap n’accepte pas la saisie de données transmises via le pipeline.
Types de retours
Test-CsPhoneBootstrap retourne une instance de l’objet Microsoft.Rtc.SyntheticTransactions.TaskOutput.TaskOutput.
Exemple
-------------------------- Exemple 1 ------------------------
Test-CsPhoneBootstrap -PhoneOrExt "+14255551219" -Pin "0712"
La commande de l’exemple 1 vérifie que l’utilisateur auquel le numéro de téléphone et le code confidentiel spécifiés ont été attribués peut se connecter à Lync Server à l’aide d’un périphérique compatible Lync 2010 Phone Edition. Pour exécuter le test, le numéro de téléphone (+14255551219) et le code confidentiel (0712) de l’utilisateur doivent être fournis.
-------------------------- Exemple 2 ------------------------
Test-CsPhoneBootstrap -PhoneOrExt "+14255551219" -Pin "0712" -UserSipAddress "sip:kenmyer@litwareinc.com"
La commande précédente vérifie si l’utilisateur auquel le numéro de téléphone et le code confidentiel spécifiés ont été attribués peut se connecter ou non à Lync Server à l’aide d’un périphérique compatible Lync 2010 Phone Edition. Dans cet exemple, le paramètre UserSipAddress permet d’effectuer une vérification supplémentaire : le test échouera si l’utilisateur doté de l’adresse SIP est différent de l’utilisateur auquel le numéro de téléphone et le code confidentiel spécifiés ont été attribués.