Test-CsDialInConferencing
Última modificación del tema: 2012-03-25
Test-CsDialInConferencing comprueba si un usuario puede participar en una sesión de conferencia de acceso telefónico.
Sintaxis
Test-CsDialInConferencing -TargetFqdn <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>] [-UserSipAddress <String>]
Test-CsDialInConferencing [-TargetFqdn <String>] -UserCredential <PSCredential> -UserSipAddress <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>]
Descripción detallada
Test-CsDialInConferencing es un ejemplo de "transacción sintética" de Microsoft Lync Server 2010. 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. Los usuarios de prueba son un par de usuarios preconfigurados para usar con transacciones sintéticas. (Normalmente se usan cuentas de prueba, no cuentas de usuarios reales.) Con los 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.
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 las cuentas de dichos usuarios (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.
Test-CsDialInConferencing intenta iniciar una sesión en el sistema con un usuario de prueba. (Si utiliza usuarios de prueba, Test-CsDialInConferencing usará la primera cuenta de prueba configurada en dicho grupo.) Si la sesión puede iniciarse sin problemas, el cmdlet usará las credenciales y permisos del usuario para intentar tener acceso a los números de conferencia de acceso telefónico. Se registrará el resultado de los intentos de acceso a cada número telefónico y, a continuación, se cerrará la sesión del usuario de prueba en Lync Server.
Test-CsDialInConferencing sólo verifica si pueden realizarse las conexiones correspondientes. El cmdlet no realiza ninguna llamada telefónica real ni crea ninguna conferencia de acceso telefónico a la que puedan unirse otros usuarios.
Quién puede ejecutar este cmdlet: de forma predeterminada, están autorizados para ejecutar el cmdlet Test-CsDialInConferencing localmente los miembros de los siguientes grupos: 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 (incluidos los roles de RBAC personalizados que haya creado), ejecute el siguiente comando en el símbolo del sistema de Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Test-CsDialInConferencing"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
TargetFqdn |
Requerido |
Cadena de caracteres |
Nombre de dominio completo (FQDN) del grupo que se probará. |
UserCredential |
Requerido |
Objeto PSCredential |
Objeto de credencial de la cuenta de usuario que se probará. 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 lo almacena en una variable llamada $x: $x = Get-Credential "litwareinc\kenmyer" Debe especificar la contraseña del usuario al ejecutar este comando. Este parámetro no es obligatorio si realiza la prueba utilizando las opciones de configuración de supervisión de mantenimiento. |
UserSipAddress |
Requerido |
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 realiza la prueba utilizando las opciones de configuración de supervisión de mantenimiento. |
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. |
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. |
Verbose |
Opcional |
Parámetro modificador |
Genera informes detallados sobre la actividad que aparecen en pantalla a medida que el cmdlet se ejecuta. |
Force |
Opcional |
Parámetro modificador |
Suprime la visualización de los mensajes de error que no sean irrecuperables y que puedan surgir al ejecutar el comando. |
Tipos de entrada
Ninguno. Test-CsDialInConferencing no acepta la entrada por canalización.
Tipos de valores devueltos
Test-CsDialInConferencing devuelve una instancia del objeto Microsoft.Rtc.SyntheticTransactions.TaskOutput.
Ejemplo
-------------------------- Ejemplo 1 --------------------------
Test-CsDialInConferencing -TargetFqdn atl-cs-001.litwareinc.com
El ejemplo anterior verifica si el usuario de prueba preconfigurado puede participar en una conferencia de acceso telefónico en el grupo de servidores atl-cs-001.litwareinc.com. 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 averiguará si el primer usuario de prueba puede iniciar sesión en Lync Server.
Si no se han definido usuarios de prueba, el comando provocará un error porque no sabrá con qué usuario iniciar sesión. Si no se ha definido ningún usuario de prueba para un grupo de servidores, es necesario incluir el parámetro UserCredential y las credenciales del usuario que debe utilizar el comando al intentar iniciar una sesión.
-------------------------- Ejemplo 2 --------------------------
$cred1 = Get-Credential "litwareinc\pilar"
Test-CsDialInConferencing -TargetFqdn atl-cs-001.litwareinc.com -UserSipAddress "sip:pilar@litwareinc.com" -UserCredential $cred1
Los comandos del Ejemplo 2 comprueban si un usuario especificado (litwareinc\pilar) puede participar en una conferencia de acceso telefónico en el grupo de servidores atl-cs-001.litwareinc.com. 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 administrador tiene que introducir solamente la contraseña de la cuenta de Pilar Ackerman en el cuadro de diálogo de solicitud de credenciales de Windows PowerShell.) El objeto de credencial resultante se almacena en una variable llamada $cred1.
El segundo comando comprueba si el usuario Pilar Ackerman puede iniciar una sesión en el grupo de servidores atl-cs-001.litwareinc.com y participar en una conferencia de acceso telefónico. Para ello, se llama a Test-CsDialInConferencing con tres parámetros: TargetFqdn (el nombre de dominio completo del grupo de registrador); UserCredential (el objeto de Windows PowerShell que contiene las credenciales de usuario Pilar Ackerman), y UserSipAddress (la dirección SIP correspondiente a las credenciales de usuario suministradas).