Test-CsAddressBookWebQuery
Última modificación del tema: 2012-03-25
Prueba la capacidad de un usuario para buscar y devolver información de la libreta de direcciones mediante el Servicio de consulta web de libreta de direcciones.
Sintaxis
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>]
Descripción detallada
Test-CsAddressBookWebQuery es un ejemplo de "transacción sintética". Las transacciones sintéticas se usan en Microsoft Lync Server 2010 para comprobar que los usuarios pueden completar correctamente tareas comunes, como iniciar sesión en el sistema, intercambiar mensajes instantáneos o realizar llamadas a teléfonos de la red telefónica conmutada (RTC). Estas pruebas puede realizarlas un administrador de manera manual o puede ejecutarlas automáticamente una aplicación, como Microsoft System Center Operations Manager (anteriormente Microsoft Operations Manager).
Hay dos métodos para llevar a cabo transacciones sintéticas. Muchos administradores usarán los cmdlets CsHealthMonitoringConfiguration para configurar usuarios de prueba para cada grupo de registrador. Estos usuarios de prueba son un par de usuarios preconfigurados para usar transacciones sintéticas. (Normalmente se usan cuentas de prueba, no cuentas de usuarios reales.) Con los usuarios de prueba configurados para un grupo de servidores, los administradores pueden ejecutar una transacción sintética con el grupo, sin necesidad de especificar las identidades, ni suministrar las credenciales, de las cuentas de usuario usadas para la prueba.
También es posible ejecutar una transacción sintética usando cuentas de usuario reales. Por ejemplo, si dos usuarios no pueden intercambiar mensajes instantáneos, un administrador puede ejecutar una transacción sintética usando esas dos cuentas de usuario (en lugar de dos cuentas de prueba) e intentar diagnosticar y resolver el problema. Para llevar a cabo una transacción sintética usando cuentas de usuario reales, deberá especificar los nombres de usuario y las contraseñas de cada usuario.
El cmdlet Test-CsAddressBookWebQuery permite a los administradores verificar que los usuarios pueden usar el Servicio de consulta web de libreta de direcciones para buscar a un determinado contacto. Al ejecutar el cmdlet, Test-CsAddressBookWebQuery se conectará primero al servicio de vales web para autenticarse. Si la autenticación se lleva a cabo correctamente, el cmdlet se conectará entonces a Servicio de consulta web de libreta de direcciones y buscará el contacto. Si lo encuentra, el cmdlet intentará devolver la información al equipo local. La prueba solo se considerará superada si se completan todos estos pasos.
Quién puede ejecutar este cmdlet: Para devolver una lista de todos los roles de control de acceso basado en roles (RBAC) a los que se ha asignado este cmdlet (incluido cualquier otro rol RBAC personalizado que usted mismo haya creado), ejecute el siguiente comando desde Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Test-CsAddressBookWebQuery"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
TargetFqdn |
Requerido |
Cadena de caracteres |
Nombre de dominio completo (FQDN) del grupo de registrador en el que se probará la Servicio de consulta web de libreta de direcciones. Por ejemplo: -TargetFqdn "atl-cs-001.litwareinc.com". Tenga en cuenta que no se pueden utilizar ambos parámetros, TargetUri y TargetFqdn, dentro del mismo comando. |
TargetSipAddress |
Requerido |
Dirección SIP |
Dirección SIP del contacto que se espera que devuelva el Servicio de consulta web de libreta de direcciones. Por ejemplo: -TargetSipAddress "sip:kenmyer@litwareinc.com". |
TargetUri |
Requerido |
Cadena de caracteres |
Identificador de recursos uniforme (URI) de Servicio de consulta web de libreta de direcciones. Por ejemplo: -TargetUri "https://atl-cs-001.litwareinc.com/groupexpansion". Tenga en cuenta que no se pueden utilizar ambos parámetros, TargetUri y TargetFqdn, dentro del mismo comando. |
UserCredential |
Requerido |
Objeto PSCredential |
Objeto de credencial de usuario de la cuenta de usuario que se usará en la prueba. El valor transferido a -UserCredential debe ser una referencia a objeto obtenida usando el cmdlet Get-Credential. Por ejemplo, este código devuelve un objeto de credenciales del usuario litwareinc\kenmyer y almacena dicho objeto en una variable llamada $x: $x = Get-Credential "litwareinc\kenmyer" Debe facilitar la contraseña de usuario al ejecutar este comando. |
UserSipAddress |
Requerido |
Dirección SIP |
Dirección SIP del usuario que se usará en la prueba. Si este parámetro no está especificado, Test-CsAddressBookWebQuery realizará comprobaciones utilizando las opciones de configuración de supervisión del mantenimiento para el grupo que se está probando. |
External |
Opcional |
Parámetro modificador |
Permite verificar si los usuarios externos pueden usar la Servicio de consulta web de libreta de direcciones. |
RegistrarPort |
Opcional |
Entero |
Puerto SIP usado por el servicio de registrador. Este parámetro no es necesario si el registrador usa el puerto predeterminado 5061. |
WebCredential |
Opcional |
Objeto PSCredential |
Objeto que contiene credenciales de usuario para obtener acceso al servicio de información de ubicaciones. Este objeto se puede recuperar llamando al cmdlet Get-Credential y facilitando las credenciales correspondientes. Este parámetro es necesario si se han especificado los parámetros TargetUri y UserSipAddress y si el equipo en el que el comando se ejecuta carece de un certificado de servidor. |
Force |
Opcional |
Parámetro modificador |
Suprime la visualización de los mensajes de error que no sean graves y que puedan ocurrir al ejecutar el comando. |
OutVerboseVariable |
Opcional |
Cadena de caracteres |
Cuando esté presente, el resultado detallado de ejecutar el cmdlet se almacenará en la variable especificada. Por ejemplo, para almacenar resultados en una variable llamada $TestOutput, utilice la sintaxis siguiente: -OutVerboseVariable TestOutput No anteponga un carácter $ al especificar el nombre de variable. |
Verbose |
Opcional |
Parámetro modificador |
Genera informes detallados sobre la actividad que aparecen en pantalla a medida que el cmdlet se ejecuta. |
Tipos de entrada
Ninguno. Test-CsAddressBookWebQuery no acepta los datos transferidos.
Tipos de valores devueltos
Test-CsAddressBookWebQuery devuelve una instancia del objeto Microsoft.Rtc.SyntheticTransactions.TaskOutput.
Ejemplo
-------------------------- Ejemplo 1 ------------------------
Test-CsAddressBookWebQuery -TargetFqdn atl-cs-001.litwareinc.com -TargetSipAddress "sip:kenmyer@litwareinc.com"
En el ejemplo anterior se prueba el Servicio de consulta web de libreta de direcciones con el grupo atl-cs-001.litwareinc.com; para ello, se busca al contacto con la dirección SIP sip:kenmyer@litwareinc.com. Este comando solo funcionará si se han definido usuarios de prueba para el grupo atl-cs-001.litwareinc.com. Si se ha definido, el comando se ejecutará con las credenciales del primer usuario de pruebas definido para este grupo.
Si no se han definido los usuarios de prueba, el comando no se ejecutará correctamente. Si no se han definido usuarios de prueba para un grupo, debe incluir el parámetro UserSipAddress y las credenciales del usuario con el que debe ejecutarse el comando.
-------------------------- Ejemplo 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"
Los comandos del Ejemplo 2 también sirven para probar la disponibilidad de Servicio de consulta web de libreta de direcciones; sin embargo, en este caso, los comandos se ejecutan con las credenciales del usuario Ken Myer (litwareinc\kenmyer). Para hacerlo, el primer comando usa el cmdlet Get-Credential para crear un objeto de credenciales Windows PowerShell que contiene el nombre y la contraseña del usuario Ken Myer. (Dado que el nombre de inicio de sesión, litwareinc\kenmyer, se ha incluido como parámetro, el cuadro de diálogo de solicitud de credenciales de Windows PowerShell pedirá al administrador que escriba únicamente la contraseña de la cuenta de Ken Myer). El objeto de credenciales resultante se almacena a continuación en una variable llamada $cred1.
En el segundo comando, se usa Test-CsAddressBookWebQuery para probar Servicio de consulta web de libreta de direcciones en el grupo atl-cs-001.litwareinc.com. Para ejecutar este comando con las credenciales de usuario de Ken Myer, se incluye el parámetro UserCredential junto con el valor del parámetro $cred1. El comando usa también TargetSipAddress para especificar que el cmdlet debe buscar en la libreta de direcciones al contacto con la dirección SIP sip:kenmyer@litwareinc.com.
-------------------------- Ejemplo 3 ------------------------
Test-CsAddressBookWebQuery -TargetUri https://atl-cs-001.litwareinc.com/groupexpansion -UserSipAddress "sip:packerman@litwareinc.com" -TargetSipAddress "sip:kenmyer@litwareinc.com"
En el Ejemplo 3 se muestra cómo someter a prueba a Servicio de consulta web de libreta de direcciones para atl-cs-001.litwareinc.com. Para ello, se llama a Test-CsAddressBookWebQuery con tres parámetros: TargetUri, que especifica el URI de Servicio de consulta web de libreta de direcciones; UserSipAddress, que contiene la dirección SIP de Windows PowerShell correspondiente a la cuenta de usuario que se está probando y TargetSipAddress, que contiene la dirección SIP de la cuenta de usuario que se está buscando.