Test-CsAddressBookWebQuery
Dernière rubrique modifiée : 2012-03-25
Teste la capacité d’un utilisateur à rechercher et retourner des informations depuis le carnet d’adresses à l’aide du service de requête sur le Web du carnet d’adresses.
Syntaxe
Test-CsAddressBookWebQuery -TargetFqdn <String> [-External <SwitchParameter>] [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>] [-TargetSipAddress <String>] [-UserSipAddress <String>]
Test-CsAddressBookWebQuery -TargetUri <String> -UserSipAddress <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-TargetSipAddress <String>] [-WebCredential <PSCredential>]
Test-CsAddressBookWebQuery [-TargetFqdn <String>] -UserCredential <PSCredential> -UserSipAddress <String> [-External <SwitchParameter>] [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>] [-TargetSipAddress <String>]
Description détaillée
Test-CsAddressBookWebQuery 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-CsAddressBookWebQuery permet aux administrateurs de vérifier que les utilisateurs peuvent utiliser le service de requête sur le Web du carnet d’adresses afin d’y rechercher un contact spécifique. Lors de l’exécution de la cmdlet, Test-CsAddressBookWebQuery se connecte d’abord au service de ticket sur le Web afin d’être authentifié. Si l’authentification réussit, la cmdlet se connecte ensuite au service de requête sur le Web du carnet d’adresses et recherche le contact indiqué. Si le contact est trouvé, la cmdlet tente ensuite de transmettre cette information à l’ordinateur local. Le test n’est marqué comme étant réussi que si ces étapes ont été effectuées.
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-CsAddressBookWebQuery"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
TargetFqdn |
Obligatoire |
Chaîne |
Nom de domaine complet du pool de serveurs d’inscriptions dans lequel le service de requête sur le Web du carnet d’adresses doit être testé. Par exemple : -TargetFqdn "atl-cs-001.litwareinc.com". Notez que vous ne pouvez pas utiliser les paramètres TargetUri et TargetFqdn dans la même commande. |
TargetSipAddress |
Obligatoire |
Adresse SIP |
Adresse SIP du contact devant être retournée par le service de requête sur le Web du carnet d’adresses. Par exemple : -TargetSipAddress "sip:kenmyer@litwareinc.com". |
TargetUri |
Obligatoire |
Chaîne |
URI (Uniform Resource Identifier) du service de requête sur le Web du carnet d’adresses. Par exemple : -TargetUri "https://atl-cs-001.litwareinc.com/groupexpansion". Notez que vous ne pouvez pas utiliser les paramètres TargetUri et TargetFqdn dans la même commande. |
UserCredential |
Obligatoire |
Objet Credential PS |
Objet d’identification du compte d’utilisateur à utiliser dans le test. 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 fournir un mot de passe utilisateur lors de l’exécution de cette commande. |
UserSipAddress |
Obligatoire |
Adresse SIP |
Adresse SIP de l’utilisateur à utiliser lors du test. Si ce paramètre n’est pas indiqué, la cmdlet Test-CsAddressBookWebQuery effectue ses vérifications en utilisant les paramètres de configuration d’analyse d’intégrité du pool en cours de test. |
External |
Facultatif |
Paramètre de commutateur |
Permet de vérifier que les utilisateurs externes peuvent utiliser le service de requête sur le Web du carnet d’adresses. |
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. |
WebCredential |
Facultatif |
Objet d’informations d’identification PS |
Objet dans lequel sont stockées les informations d’identification de l’utilisateur lui permettant d’accéder au service Informations d’emplacement. Cet objet peut être récupéré en appelant la cmdlet Get-Credential et en fournissant les informations d’identification appropriées. Ce paramètre est requis si les paramètres TargetUri et UserSipAddress sont spécifiés, et si l’ordinateur sur lequel vous exécutez la commande n’a pas de certificat de serveur. |
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. |
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. |
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-CsAddressBookWebQuery n’accepte pas la saisie de données transmises via le pipeline.
Types de retours
Test-CsAddressBookWebQuery retourne une instance de l’objet Microsoft.Rtc.SyntheticTransactions.TaskOutput.
Exemple
-------------------------- Exemple 1 ------------------------
Test-CsAddressBookWebQuery -TargetFqdn atl-cs-001.litwareinc.com -TargetSipAddress "sip:kenmyer@litwareinc.com"
L’exemple ci-dessus teste le service de requête sur le Web du carnet d’adresses pour le pool atl-cs-001.litwareinc.com en recherchant le contact dont l’adresse SIP est sip:kenmyer@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 s’exécute en utilisant les informations d’identification du premier utilisateur de test défini pour le pool.
Si aucun utilisateur de test n’a été défini, la commande échoue. 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 employé pour l’exécution de la commande.
-------------------------- Exemple 2 ------------------------
$cred1 = Get-Credential "litwareinc\kenmyer"
Test-CsAddressBookWebQuery -TargetFqdn atl-cs-001.litwareinc.com -UserCredential $cred1 -UserSipAddress "sip:kenmyer@litwareinc.com" -TargetSipAddress "sip:kenmyer@litwareinc.com"
Les commandes illustrées dans l’exemple 2 testent également la disponibilité du service de requête sur le Web du carnet d’adresses. Dans ce cas toutefois, les commandes s’exécutent avec les informations d’identification de l’utilisateur Ken Myer (litwareinc\kenmyer). Pour ce faire, la première commande 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 Ken Myer. (Le nom de connexion litwareinc\kenmyer é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 Ken Myer.) L’objet d’identification qui en résulte est ensuite stocké dans une variable nommée $cred1.
Dans la seconde commande, la cmdlet Test-CsAddressBookWebQuery est utilisée pour tester le service de requête sur le Web du carnet d’adresses pour le pool atl-cs-001.litwareinc.com. Pour exécuter cette commande avec les informations d’identification de l’utilisateur Ken Myer, le paramètre UserCredential est défini avec la valeur $cred1. La commande utilise également TargetSipAddress afin d’indiquer à la cmdlet qu’elle doit rechercher dans le carnet d’adresses le contact dont l’adresse SIP est sip:kenmyer@litwareinc.com.
-------------------------- Exemple 3 ------------------------
Test-CsAddressBookWebQuery -TargetUri https://atl-cs-001.litwareinc.com/groupexpansion -UserSipAddress "sip:packerman@litwareinc.com" -TargetSipAddress "sip:kenmyer@litwareinc.com"
L’exemple 3 explique comment tester le service de requête sur le Web du carnet d’adresses pour le pool atl-cs-001.litwareinc.com. Pour ce faire, la cmdlet Test-CsAddressBookWebQuery est d’abord appelée avec trois paramètres : TargetUri, qui indique l’URI du service de requête sur le Web du carnet d’adresses, UserSipAddress, qui contient l’adresse SIP Windows PowerShell du compte d’utilisateur employé pour le test et TargetSipAddress, qui contient l’adresse SIP du compte d’utilisateur recherché.