Test-CsAddressBookService
Última modificación del tema: 2012-03-26
Prueba la capacidad de un usuario para obtener acceso al servidor que hospeda el Servicio web de descarga de libreta de direcciones.
Sintaxis
Test-CsAddressBookService -TargetFqdn <String> [-External <SwitchParameter>] [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>] [-UserSipAddress <String>]
Test-CsAddressBookService -TargetUri <String> -UserSipAddress <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-WebCredential <PSCredential>]
Test-CsAddressBookService [-TargetFqdn <String>] -UserCredential <PSCredential> -UserSipAddress <String> [-External <SwitchParameter>] [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>]
Descripción detallada
Test-CsAddressBookService es un ejemplo de "transacción sintética". Las transacciones sintéticas se usan en 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-CsAddressBookService permite verificar si un usuario puede conectarse a Servicio web de descarga de libreta de direcciones. Al ejecutar el cmdlet, Test-CsAddressBookService se conecta al Servicio web de descarga de libreta de direcciones del grupo especificado y solicita la ubicación de los archivos de libreta de direcciones. Si el Servicio web de descarga de libreta de direcciones proporciona la ubicación, se considera que el resultado de la prueba es correcto. Si se deniega la solicitud, el resultado de la prueba es erróneo.
El Servicio web de descarga de libreta de direcciones se puede probar de dos formas diferentes: con la prueba del propio servicio o del servicio web asociado.
Quién puede ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos tienen autorización para ejecutar el cmdlet Test-CsAddressBookService de forma local: RTCUniversalServerAdmins. 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-CsAddressBookService"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
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 no se especifica este parámetro, Test-CsAddressBookService llevará a cabo las comprobaciones con la cuenta del usuario que haya iniciado sesión. |
External |
Opcional |
Parámetro modificador |
Permite verificar si los usuarios externos pueden usar la Servicio web de descarga 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. |
TargetFqdn |
Opcional |
Cadena de caracteres |
Nombre de dominio completo (FQDN) del grupo de registrador en el que se probará el Servicio web de descarga de libreta de direcciones. Por ejemplo: -TargetFqdn "atl-cs-001.litwareinc.com". No se pueden utilizar ambos parámetros, TargetUri y TargetFqdn, dentro del mismo comando. |
TargetUri |
Opcional |
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/abs/handler". No se pueden utilizar ambos parámetros, TargetUri y TargetFqdn, dentro del mismo comando. |
WebCredential |
Opcional |
Objetos 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 |
Requerido |
Parámetro modificador |
Notifica los detalles de la actividad en la pantalla mientras se ejecuta el cmdlet. |
Tipos de entrada
Ninguno. Test-CsAddressBookService no acepta los datos transferidos.
Tipos de valores devueltos
Test-CsAddressBookService devuelve una instancia del objeto Microsoft.Rtc.SyntheticTransactions.TaskOutput.
Ejemplo
-------------------------- Ejemplo 1 --------------------------
Test-CsAddressBookService -TargetFqdn atl-cs-001.litwareinc.com
En el ejemplo anterior, se prueba el Servicio web de descarga de libreta de direcciones para el grupo atl-cs-001.litwareinc.com. Este comando prueba el Servicio web de descarga de libreta de direcciones con los usuarios de prueba preconfigurados para el grupo atl-cs-001.litwareinc.com.
-------------------------- Ejemplo 2 --------------------------
$cred1 = Get-Credential "litwareinc\kenmyer"
Test-CsAddressBookService -TargetFqdn atl-cs-001.litwareinc.com -UserCredential $cred1 -UserSipAddress "sip:kenmyer@litwareinc.com"
Los comandos del Ejemplo 2 también sirven para probar la disponibilidad del servidor que ejecuta el Servicio web de descarga 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-CsAddressBookService para probar el Servicio web de descarga 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. Además, se debe especificar la dirección SIP de Ken utilizando el parámetro UserSipAddress.
-------------------------- Ejemplo 3 --------------------------
Test-CsAddressBookService -TargetUri https://atl-cs-001.litwareinc.com/abs/handler -UserSipAddress "sip:kenmyer@litwareinc.com"
En el Ejemplo 3 se muestra cómo probar el Servicio web de descarga de libreta de direcciones para atl-cs-001.litwareinc.com. Para ello, se llama a Test-CsAddressBookService con dos parámetros: TargetUri, que especifica el URI del Servicio web de descarga de libreta de direcciones; y UserSipAddress, que contiene la dirección SIP Windows PowerShell de la cuenta de usuario que se usa en la prueba.