Test-CsGroupIM
Última modificación del tema: 2012-03-26
Prueba la capacidad de dos usuarios de realizar una conferencia de mensajería instantánea (IM). Test-CsGroupIM es una "transacción sintética": es una simulación de actividades comunes de Microsoft Lync Server 2010 usadas para el seguimiento de estado y rendimiento.
Sintaxis
Test-CsGroupIM -TargetFqdn <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-ReceiverSipAddress <String>] [-RegistrarPort <Nullable>] [-SenderSipAddress <String>]
Test-CsGroupIM [-TargetFqdn <String>] -ReceiverCredential <PSCredential> -ReceiverSipAddress <String> -SenderCredential <PSCredential> -SenderSipAddress <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>]
Descripción detallada
Test-CsGroupIM 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 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 dos usuarios no pueden intercambiar mensajes instantáneos, un administrador puede ejecutar una transacción sintética con las cuentas de dichos usuarios (en lugar de dos cuentas de prueba) y, a continuación, intentar 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-CsGroupIM lo habilita para comprobar que los usuarios de la organización son capaces de realizar conferencias. Test-CsGroupIM requiere de dos cuentas de usuarios para llevar a cabo sus pruebas. Si ha instalado usuarios de prueba para el grupo donde se realizará la prueba, no necesita especificar las cuentas; en cambio, el Test-CsGroupIM usará automáticamente las cuentas de prueba asignadas al grupo. (Para obtener más información, consulte el tema de ayuda de New-CsHealthMonitoringConfiguration). También puede llevar a cabo la prueba con cuentas distintas de las asignadas al registrador. Esto le permitirá ejecutar pruebas aun sin haber configurado usuarios de prueba para el grupo. También le permite comprobar la capacidad de dos usuarios específicos para realizar una conferencia. Si decide usar este método, deberá proporcionar el nombre de usuario y la contraseña de ambos usuarios.
Al ejecutar el cmdlet Test-CsGroupIM, éste intenta iniciar la sesión de ambos usuarios de prueba en Lync Server. Si el resultado es correcto, Test-CsGroupIM crea una nueva conferencia con el primer usuario de prueba y, a continuación, invita al segundo usuario a unirse a ella. Después de un intercambio de mensajes, se desconecta del sistema a ambos usuarios. Todo esto ocurre sin la interacción de ningún usuario y sin afectar a los usuarios reales. Por ejemplo, supongamos que la cuenta de prueba sip:kenmyer@litwareinc.com corresponde a un usuario real con una cuenta real de Lync Server. En ese caso, la prueba se realizará sin ningún tipo de interrupción ocasionada al Ken Myer real. Por ejemplo, aunque la cuenta de prueba de Ken Myer cierre sesión en el sistema, Ken Myer, la persona, permanecerá conectado. De manera similar, el usuario Ken Myer real no recibirá ninguna invitación a unirse a la conferencia. Dicha invitación se enviará a la cuenta de prueba y será esta la que aceptará.
Agregar el parámetro Verbose lo habilita para obtener un detalle de todas las acciones que realizó Test-CsGroupIM para completar la 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-CsGroupIM"}
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á. |
ReceiverCredential |
Opcional |
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:pilar@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. |
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. |
SenderCredential |
Opcional |
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 |
Opcional |
Cadena de caracteres |
Dirección SIP de la segunda de las dos cuentas de usuario que se pondrán a prueba. Por ejemplo: -SenderSipAddres "sip:kenmyer@litwareinc.com". El parámetro SenderSIPAddress debe hacer referencia 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. |
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-CsGroupIM no acepta entradas canalizadas.
Tipos de valores devueltos
Test-CsGroupIM devuelve una instancia del objeto Microsoft.Rtc.SyntheticTransactions.TaskOutput.
Ejemplo
-------------------------- Ejemplo 1 --------------------------
Test-CsGroupIm -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 participar en una conferencia de mensajería instantánea. 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 ambos usuarios pueden iniciar sesión en el sistema y, a continuación, comprobará si pueden participar en una conferencia de mensajería instantánea.
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 han definido usuarios de prueba para un grupo, deberá incluir los parámetros SenderSipAddress y ReceiverSipAddress y las credenciales correspondientes de los usuarios implicados en la sesión de mensajería instantánea. A continuación, Test-CsGroupIM realizará sus comprobaciones con los dos usuarios especificados.
-------------------------- Ejemplo 2 --------------------------
$cred1 = Get-Credential "litwareinc\pilar"
$cred2 = Get-Credential "litwareinc\kenmyer"
Test-CsGroupIm -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, a continuación, participar en una conferencia de mensajería instantánea 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 resultante 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 o no pueden iniciar sesión en Lync Server y participar en una conferencia de mensajería instantánea. Para llevar a cabo esta tarea, se llama a Test-CsGroupIM junto con los siguientes parámetros: TargetFqdn (el nombre de dominio completo del grupo de registrador); SenderSipAddress (la dirección SIP del primer usuario); SenderCredential (las credenciales de usuario del primer usuario); ReceiverSipAddress (la dirección SIP del segundo usuario); y ReceiverCredential (las credenciales de usuario del segundo usuario).