Test-CsPresence
Última modificación del tema: 2012-03-26
Prueba la capacidad de un usuario de iniciar sesión en Microsoft Lync Server 2010, publicar su información de presencia y, luego, suscribirse a la información de presencia publicada por un segundo usuario.
Sintaxis
Test-CsPresence -TargetFqdn <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-PublisherSipAddress <String>] [-RegistrarPort <Nullable>] [-SubscriberSipAddress <String>] [-SubscriberSipAddress <String>]
Test-CsPresence [-TargetFqdn <String>] -PublisherCredential <PSCredential> -PublisherSipAddress <String> -SubscriberCredential <PSCredential> -SubscriberSipAddress <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>] [-SubscriberSipAddress <String>]
Descripción detallada
Test-CsPresence es un ejemplo de transacción sintética de Lync Server 2010. Las transacciones sintéticas se usan en Lync Server 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).
Normalmente, las transacciones sintéticas se llevan a cabo de dos modos distintos. Muchos administradores usarán los cmdlets CsHealthMonitoringConfiguration para configurar a los usuarios de prueba para cada grupo de registrador. Normalmente se usan cuentas de prueba, no cuentas de usuarios reales. Con estas cuentas de usuarios configuradas para un grupo, los administradores simplemente pueden ejecutar una transacción sintética en dicho grupo sin tener que especificar las identidades de las cuentas de usuario implicadas en la prueba, ni facilitar sus credenciales.
De forma alternativa, los administradores pueden ejecutar una transacción sintética con cuentas de usuarios reales. Por ejemplo, si un usuario no puede intercambiar mensajes instantáneos con otro, un administrador puede ejecutar una transacción sintética con las dos cuentas de usuario en cuestión (en lugar de dos cuentas de prueba) y tratar de diagnosticar y resolver el problema. Si decide llevar a cabo una transacción sintética con cuentas de usuario reales, deberá especificar los nombres de usuario y las contraseñas de cada usuario.
Test-CsPresence se usa para determinar si un par de usuarios de prueba puede iniciar sesión de Lync Server y, luego, intercambiar información de presencia. Para esto, el cmdlet primero inicia la sesión de ambos usuarios en el sistema. Si los dos inicios de sesión se realizan correctamente, el primer usuario de prueba solicita recibir información de presencia del segundo usuario. El segundo usuario publica esta información y Test-CsPresence comprueba que esta se transmita correctamente al primer usuario. Después de que intercambian información de presencia, se cierra la sesión de Lync Server de los usuarios de prueba.
Quiénes pueden ejecutar este cmdlet: Para obtener una lista de todos los roles de control de acceso basado en roles (RBAC) que se han asignado a este cmdlet (incluidos los roles personalizados RBAC que haya creado usted), ejecute el siguiente comando en el aviso de Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Test-CsPresence"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
TargetFqdn |
Requerido |
Cadena de caracteres |
Nombre de dominio completo (FQDN) del grupo de servidores que se probará. |
PublisherCredential |
Requerido |
Objeto de credencial de PS |
Objeto de credencial de usuario para la primera de las cuentas de usuario que se someterán a prueba. El valor enviado a PublisherCredential debería ser una referencia a objeto obtenida mediante el cmdlet Get-Credential. Por ejemplo, este código devuelve un objeto de credencial para el usuario litwareinc\kenmyer y almacena ese objeto en una variable denominada $x: $x = Get-Credential "litwareinc\kenmyer" Deberá proporcionar la contraseña de usuario cuando ejecuta este comando. La credencial del publicador no es obligatoria si la prueba se ejecuta con la configuración de seguimiento de estado para el grupo. |
PublisherSipAddress |
Requerido |
Dirección SIP |
Dirección SIP de la primera cuenta de usuario que se someterá a prueba. Por ejemplo: -PublisherSipAddress "sip:kenmyer@litwareinc.com". El parámetro PublisherSipAddress debe hacer referencia a la misma cuenta de usuario que PublisherCredential. La dirección SIP no es obligatoria si la prueba se ejecuta con la configuración de seguimiento de estado del grupo. |
SubscriberCredential |
Requerido |
Objeto de credencial de PS |
Objeto de credencial de usuario para la segunda de las cuentas de usuario que se someterán a prueba. El valor enviado a SubscriberCredential debería ser una referencia a objeto obtenida mediante el cmdlet Get-Credential. Por ejemplo, este código devuelve un objeto de credenciales del usuario litwareinc\pilar y almacena dicho objeto en una variable llamada $y: $y = Get-Credential "litwareinc\pilar" Deberá proporcionar la contraseña de usuario cuando ejecuta este comando. La credencial del suscriptor no es obligatoria si la prueba se ejecuta con la configuración de seguimiento de estado para el grupo. |
SubscriberSipAddress |
Requerido |
Dirección SIP |
Dirección SIP de la segunda cuenta de usuario que se someterá a prueba. Por ejemplo: -SubscriberSipAddress "sip:pilar@litwareinc.com". El parámetro SubscriberSipAddress debe hacer referencia a la misma cuenta de usuario que SubscriberCredential. La dirección SIP no es obligatoria si la prueba se ejecuta con la configuración de seguimiento de estado del grupo. |
RegistrarPort |
Opcional |
Integer |
Puerto SIP usado por el servicio de registrador. Este parámetro no es obligatorio si el registrador usa el puerto predeterminado 5061. |
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. |
Force |
Opcional |
Parámetro modificador |
Suprime la visualización de los mensajes de error que no sean graves y que puedan producirse al ejecutar el comando. |
Verbose |
Opcional |
Cadena de caracteres |
Informa la actividad en la pantalla de manera detallada mientras se ejecuta el cmdlet. |
Tipos de entrada
Ninguno. Test-CsPresence no acepta entradas canalizadas.
Tipos de valores devueltos
Test-CsPresence devuelve una instancia del objeto Microsoft.Rtc.SyntheticTransactions.TaskOutput.
Ejemplo
-------------------------- Ejemplo 1 --------------------------
Test-CsPresence -TargetFqdn atl-cs-001.litwareinc.com
En el ejemplo anterior, se comprueba si un par de usuarios de prueba preconfigurados pueden iniciar sesión en el grupo atl-cs-001.litwareinc.com; después de que los usuarios de prueba hayan iniciado sesión, Test-CsPresence comprueba si los dos usuarios pueden intercambiar información de presencia. Este comando sólo funcionará si se han definido usuarios de prueba para el grupo de servidores atl-cs-001.litwareinc.com. Si es así, el comando determinará si el primer usuario de prueba puede iniciar sesión en el sistema y luego comprobará si este usuario puede intercambiar información de presencia con el segundo usuario de prueba definido para el grupo.
Si no se ha definido ningún registrador, el comando no funcionará porque no sabrá qué usuarios debe usar al realizar la prueba. Si no ha definido usuarios de prueba para un grupo de servidores, deberá incluir los parámetros SubscriberSipAddress y PublisherSipAddress además de las credenciales correspondientes para los usuarios que actúan como suscriptor y publicador de presencia. Test-CsPresence después realizará sus comprobaciones con los dos usuarios especificados.
-------------------------- Ejemplo 2 --------------------------
$cred1 = Get-Credential "litwareinc\pilar"
$cred2 = Get-Credential "litwareinc\kenmyer"
Test-CsPresence -TargetFqdn atl-cs-001.litwareinc.com -SubscriberSipAddress "sip:pilar@litwareinc.com" -SubscriberCredential $cred1 -PublisherSipAddress "sip:kenmyer@litwareinc.com" -PublisherCredential $cred2
Los comandos que se muestran en el Ejemplo 2 prueban la capacidad de un par de usuarios (litwareinc\pilar y litwareinc\kenmyer) de iniciar sesión en Lync Server, y después intercambiar información de presencia. Para ello, el primer comando del ejemplo usa el cmdlet Get-Credential para crear un objeto de credencial Windows PowerShell con el nombre y la contraseña del usuario Pilar Ackerman. (Dado que el nombre de inicio de sesión, litwareinc\pilar, 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 Pilar Ackerman). Luego, el objeto de credencial resultante se almacena en una variable denominada $cred1. El segundo comando hace lo mismo, pero devuelve un objeto de credenciales para la cuenta de Ken Myer.
Con ambos objetos credencial en mano, el tercer comando del ejemplo determina si los dos usuarios pueden iniciar sesión en Lync Server e intercambiar información de presencia, o no. Para llevar a cabo esta tarea, se llama a Test-CsPresence con los siguientes parámetros: TargetFqdn (el FDQN del grupo de registrador); SubscriberSipAddress (la dirección SIP del usuario de prueba); SubscriberCredential (el Windows PowerShell objeto que contiene las credenciales de este mismo usuario); PublisherSipAddress (la dirección SIP del otro usuario de prueba); y PublisherCredential (el objeto de Windows PowerShell que contiene las credenciales del otro usuario).