Test-CsIM
Última modificación del tema: 2012-03-26
Prueba la capacidad de dos usuarios para intercambiar mensajes instantáneos.
Sintaxis
Test-CsIM -TargetFqdn <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-ReceiverSipAddress <String>] [-RegistrarPort <Nullable>] [-SenderSipAddress <String>]
Test-CsIM [-TargetFqdn <String>] -ReceiverCredential <PSCredential> -ReceiverSipAddress <String> -SenderCredential <PSCredential> -SenderSipAddress <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>]
Descripción detallada
Test-CsIM es un ejemplo de Microsoft Lync Server 2010 "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).
Normalmente, las transacciones sintéticas se llevan a cabo de dos modos distintos. Muchos administradores usarán los cmdlets CsHealthMonitoringConfiguration para configurar un usuario de prueba para cada grupo de registrador. Estos usuarios de prueba son un par de usuarios que han sido preconfigurados para usar transacciones sintéticas. (Normalmente se usan cuentas de prueba, no cuentas pertenecientes a usuarios reales). Con los usuarios de prueba configurados para un grupo, los administradores simplemente 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.
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 las credenciales de cada usuario.
El cmdlet Test-CsIM comienza a intentar iniciar la sesión de un par de usuarios de prueba en Lync Server. Si los dos inicios de sesión se realizan correctamente, el cmdlet inicia una sesión de mensajería instantánea (IM) entre los dos usuarios de prueba. (El Usuario 1 invita al Usuario 2 a una sesión de mensajería instantánea y el Usuario 2 acepta la invitación). Después de comprobar que los mensajes pueden intercambiarse entre los dos usuarios, Test-CsIM finaliza la sesión de mensajería instantánea y cierra la sesión de ambos usuarios en el sistema.
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-CsIM"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
ReceiverCredential |
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 ReceiverCredential 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 receptor no es obligatoria si ejecuta la prueba con la configuración de seguimiento de estado del grupo. |
ReceiverSipAddress |
Opcional |
Cadena de caracteres |
Dirección SIP de la primera cuenta de usuario que se someterá a prueba. Por ejemplo: -ReceiverSipAddress "sip:jhaas@litwareinc.com". El parámetro ReceiverSipAddress debe hacer referencia a la misma cuenta de usuario que ReceiverCredential. La dirección SIP no es obligatoria si la prueba se ejecuta con la configuración de seguimiento de estado del grupo. |
SenderCredential |
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 SenderCredential 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 remitente no es obligatoria si ejecuta la prueba con la configuración de seguimiento de estado del grupo. |
SenderSipAddress |
Requerido |
Cadena de caracteres |
Dirección SIP de la segunda cuenta de usuario que se someterá a prueba. Por ejemplo: -SenderSipAddress "sip:kenmyer@litwareinc.com". El parámetro SenderSipAddress debe referirse a la misma cuenta de usuario que SenderCredential. La dirección SIP no es obligatoria si la prueba se ejecuta con la configuración de seguimiento de estado del grupo. |
TargetFqdn |
Requerido |
Cadena de caracteres |
Nombre de dominio completo (FQDN) del grupo de servidores que se probará. |
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 |
Parámetro modificador |
Informa la actividad en la pantalla de manera detallada mientras se ejecuta el cmdlet. |
Tipos de entrada
Ninguno. Test-CsIM no acepta entradas canalizadas.
Tipos de valores devueltos
Test-CsIM devuelve una instancia del objeto Microsoft.Rtc.SyntheticTransactions.TaskOutput.
Ejemplo
-------------------------- Ejemplo 1 --------------------------
Test-CsIm -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 y, luego, intercambiar mensajes instantáneos. Este comando sólo funcionará si se han definido usuarios de prueba para el grupo de servidores atl-cs-001.litwareinc.com. Si se ha definido, el comando determinará si los dos usuarios pueden iniciar sesión en el sistema y, de ser así, pueden intercambiar mensajes instantáneos. Si
no se han definido usuarios de prueba, se producirá un error en el comando porque no sabrá qué usuario emplear para realizar la prueba. Si no ha definido registradores para un grupo de servidores, deberá incluir los parámetros SenderSipAddress y ReceiverSipAddress además de las credenciales correspondientes de los usuarios involucrados en la sesión de mensajería instantánea. A continuación, Test-CsIM realizará sus comprobaciones con los dos usuarios especificados.
-------------------------- Ejemplo 2 --------------------------
$cred1 = Get-Credential "litwareinc\pilar"
$cred2 = Get-Credential "litwareinc\kenmyer"
Test-CsIm -TargetFqdn atl-cs-001.litwareinc.com -SenderSipAddress "sip:pilar@litwareinc.com" -SenderCredential $cred1 -ReceiverSipAddress "sip:kenmyer@litwareinc.com" -ReceiverCredential $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 mensajes instantáneos. 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 y, a continuación, intercambiar mensajes instantáneos. Para ello, se llama a Test-CsIM, junto con los siguientes parámetros: TargetFqdn (el FDQN del grupo de registrador); SenderSipAddress (la dirección SIP del primer usuario de prueba); SubscriberCredential (el Windows PowerShell objeto que contiene las credenciales de este mismo usuario); -ReceiverSipAddress (la dirección SIP del otro usuario de prueba); y ReceiverCredential (el objeto de Windows PowerShell que contiene las credenciales del otro usuario).