Test-CsRegistration
Última modificación del tema: 2012-03-26
Prueba la capacidad del usuario de iniciar sesión en Microsoft Lync Server 2010. Test-CsRegistration es una "transacción sintética": una simulación de actividades comunes de Lync Server 2010 usadas para la supervisión de mantenimiento y rendimiento.
Sintaxis
Test-CsRegistration -TargetFqdn <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>] [-UserSipAddress <String>]
Test-CsRegistration [-TargetFqdn <String>] -UserCredential <PSCredential> -UserSipAddress <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>]
Descripción detallada
Test-CsRegistration es un ejemplo de "transacción sintética" de Lync Server. 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 usuarios de prueba para cada grupo de registrador. Estos usuarios de prueba son un par de usuarios que se han preconfigurado para usarse con transacciones sintéticas. (Normalmente se usan cuentas de prueba, no cuentas de usuarios reales.) Con usuarios de prueba configurados para un grupo, 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.
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. Tenga en cuenta que para llevar a cabo una transacción sintética usando cuentas de usuario reales deberá especificar los nombres de inicio de sesión y las contraseñas de cada usuario.
El cmdlet Test-CsRegistration le permite comprobar que los usuarios de su organización pueden iniciar sesión en MLync Server. Para realizar esta comprobación, Test-CsRegistration requiere una única cuenta de prueba. Si ha configurado usuarios de prueba para el grupo donde se realizará la prueba, no necesita especificar una cuenta; en su lugar, Test-CsRegistration usará automáticamente la primera cuenta de prueba asignada al grupo. (Para obtener más información, consulte el tema de ayuda New-CsHealthMonitoringConfiguration. También puede realizar la prueba con una cuenta que no se haya asignado al grupo. Esto le permitirá ejecutar pruebas aun sin haber configurado usuarios de prueba. Asimismo, le permitirá probar la capacidad de un usuario específico de iniciar sesión en Lync Server. (Si elige usar este método, deberá proporcionar el nombre del usuario y la contraseña para la cuenta que se prueba).
Cuando ejecuta Test-CsRegistration, el cmdlet intenta que el usuario de prueba inicie sesión en Lync Server y, a continuación, si lo logra, desconecta al usuario de prueba del sistema. 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. Cuando la prueba de Ken Myer cierre sesión en el sistema, Ken Myer (la persona) permanecerá conectado.
Agregar el parámetro Verbose le permitirá obtener una cuenta detallada de las acciones realizadas por Test-CsRegistration para finalizar su 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-CsRegistration"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
TargetFqdn |
Requerido |
Cadena de caracteres |
Nombre de dominio completo (FQDN) del grupo que se probará. |
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 los nombres de variable. |
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. |
UserCredential |
Opcional |
Objeto de credencial de PS |
Objeto de credencial de usuario de la cuenta de usuario que se someterá a prueba. El valor enviado a UserCredential deberá 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. Este parámetro no es obligatorio si ejecuta la prueba con las opciones configuración de supervisión de mantenimiento del grupo. |
UserSipAddress |
Opcional |
Dirección SIP |
Dirección SIP de la cuenta de usuario que se probará, por ejemplo: -UserSipAddress "sip:kenmyer@litwareinc.com". El parámetro UserSipAddress debe hacer referencia a la misma cuenta de usuario que UserCredential. Este parámetro no es obligatorio si ejecuta la prueba con las opciones configuración de supervisión de mantenimiento del grupo. |
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-CsRegistration no acepta entradas canalizadas.
Tipos de valores devueltos
Test-CsRegistration devuelve una instancia del objeto Microsoft.Rtc.SyntheticTransactions.TaskOutput.
Ejemplo
-------------------------- Ejemplo 1 --------------------------
Test-CsRegistration -TargetFqdn atl-cs-001.litwareinc.com
En el ejemplo anterior, se prueba el servicio de registrador para el grupo atl-cs-001.litwareinc.com. Este comando sólo funcionará si se han definido usuarios de prueba para el grupo atl-cs-001.litwareinc.com. Si es así, el comando determinará si el primer usuario de prueba puede iniciar sesión en Lync Server.
Si no se han definido usuarios de prueba, el comando producirá un error porque no sabrá con qué usuario iniciar sesión. Si no han definido usuarios de prueba para un grupo, deberá incluir el parámetro UserSipAddress y las credenciales del usuario que debe usar el comando al intentar iniciar sesión.
-------------------------- Ejemplo 2 --------------------------
$cred1 = Get-Credential "litwareinc\pilar"
Test-CsRegistration -TargetFqdn atl-cs-001.litwareinc.com -UserCredential $cred1 -UserSipAddress "sip:pilar@litwareinc.com"
Los comandos que se muestran en el Ejemplo 2 prueban la capacidad de un usuario específico (litwareinc\pilar) de iniciar sesión en Lync Server. Para ello, el primer comando del ejemplo usa el cmdlet Get-Credential para crear un objeto de credencial de 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.
Luego, el segundo comando comprueba si este usuario puede iniciar sesión en el grupo atl-cs-001.litwareinc.com. Para ello, se llama a Test-CsRegistration con tres parámetros: TargetFqdn (el FQDN del grupo de registrador); UserCredential (el objeto de Windows PowerShell que contiene las credenciales de usuario de Pilar Ackerman); y UserSipAddress (la dirección SIP correspondiente a las credenciales de usuario suministradas).