Test-CsPstnOutboundCall
Última modificación del tema: 2012-03-26
Comprueba la capacidad de un usuario para realizar una llamada a un número telefónico ubicado en la red telefónica conmutada (RTC).
Sintaxis
Test-CsPstnOutboundCall -TargetFqdn <String> -TargetPstnPhoneNumber <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>] [-UserSipAddress <String>]
Test-CsPstnOutboundCall [-TargetFqdn <String>] -TargetPstnPhoneNumber <String> -UserCredential <PSCredential> -UserSipAddress <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>]
Descripción detallada
Test-CsPstnOutboundCall 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 los nombres de usuario y las contraseñas de cada usuario.
También se puede usar Test-CsPstnOutboundCall en modo de plataforma de servidores. En ese caso, sólo necesita especificar la dirección SIP de usuario y Lync Server 2010 usará certificados para autenticar ese usuario.
Al ejecutar el cmdlet Test-CsPstnOutboundCall, éste primero intenta iniciar la sesión del usuario de prueba en Lync Server. Si el inicio de sesión se realiza correctamente, el cmdlet intentará realizar una llamada telefónica mediante la puerta de enlace RTC. Esta llamada telefónica puede realizarse con el plan de marcado, la directiva de voz y con otras directivas y configuraciones asignadas a la cuenta de prueba. Cuando se responde la llamada, el cmdlet envía códigos de tono de marcado de frecuencia múltiple (DTMF) en la red a fin de verificar la conectividad de medios.
Cuando se lleve a cabo la prueba, Test-CsPstnOutboundCall realizará una llamada telefónica real: el teléfono de destino sonará y debe ser atendido para que la prueba sea correcta. Además, el administrador debe finalizar la llamada manualmente.
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-CsPstnOutboundCall"}
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á. |
TargetPstnPhoneNumber |
Requerido |
Cadena de caracteres |
Número telefónico RTC al que se llamará durante la realización de la prueba. El número telefónico de destino se especifica mejor al usar el formato E.164, que significa que el número se verá algo así como "+14255551298" y ese número contendrá un signo positivo (+) seguido del código de llamada del país/región (1), el código de área (425) y el número de teléfono (5551298). Al especificar el número telefónico, no use guiones, paréntesis ni ningún otro carácter. Si no usa el formato E.164, el plan de marcado del usuario de prueba se anexará al número. Lync Server 2010 después usará el plan de marcado para normalizar el número con el formato E.164. Si no se puede normalizar el número, no se puede realizar la llamada y la prueba generará un error. |
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í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. Este parámetro no es necesario si el comando emplea usuarios de prueba configurados al usar los cmdlets CsHealthMonitoringConfiguration. Además no necesita especificar este parámetro si la prueba se realiza en modo de plataforma de servidor. En ese caso, Lync Server 2010 intentará autenticar al usuario con el uso de certificados. |
UserSipAddress |
Opcional |
Dirección SIP |
Dirección SIP de la cuenta de usuario que se someterá a prueba. Por ejemplo: -SenderSipAddress "sip:kenmyer@litwareinc.com". El parámetro UserSipAddress debe hacer referencia a la misma cuenta de usuario que UserCredential. Este parámetro no es necesario si el comando emplea usuarios de prueba configurados al usar los cmdlets CsHealthMonitoringConfiguration. |
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 |
Integer |
Puerto SIP usado por el servicio de registrador. Este parámetro no es obligatorio si el registrador usa el puerto predeterminado 5061. |
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-CsPstnOutboundCall no acepta entradas canalizadas.
Tipos de valores devueltos
Test-CsPstnOutboundCall devuelve una instancia del objeto Microsoft.Rtc.SyntheticTransactions.TaskOutput.
Ejemplo
-------------------------- Ejemplo 1 --------------------------
Test-CsPstnOutboundCall -TargetFqdn atl-cs-001.litwareinc.com -TargetPstnPhoneNumber "+15551234567"
En el ejemplo anterior se comprueba si un usuario de prueba preconfigurado pueden iniciar sesión en el grupo atl-cs-001.litwareinc.com y luego hacer una llamada telefónica a través de la puerta de enlace RTC. Este comando sólo funcionará si se han definido usuarios de prueba para el grupo de servidores atl-cs-001.litwareinc.com. Si se han definido, el comando determinará si el primer usuario de prueba puede iniciar sesión en el sistema y, en caso afirmativo, si puede realizar una llamada telefónica a un teléfono ubicado en la RTC.
Si no se han definido usuarios de prueba, el comando producirá un error porque no sabrá qué usuario emplear para realizar la prueba. Si no han definido usuarios de prueba para un grupo, deberá incluir el parámetro -UserSipAddress además de las credenciales correspondientes a las cuentas de usuario involucradas en la prueba. Test-CsPstnOutboundCall después realizará sus comprobaciones con el usuario especificado.
-------------------------- Ejemplo 2 --------------------------
$cred1 = Get-Credential "litwareinc\kenmyer"
Test-CsPstnOutboundCall -TargetFqdn atl-cs-001.litwareinc.com -TargetPstnPhoneNumber "+15551234567" -UserSipAddress "sip:kenmyer@litwareinc.com" -UserCredential $cred1
Los comandos que se muestran en el Ejemplo 2 prueban la capacidad de un usuario de prueba (litwareinc\kenmyer) de iniciar sesión en Lync Server y luego realizar una llamada telefónica por la puerta de enlace RTC. 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 Ken Myer. (Dado que el nombre de inicio de sesión, litwareinc\kenmyer, 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 Ken Myer). Luego, el objeto de credencial resultante se almacena en una variable denominada $cred1.
Con el objeto de credencial en mano, el segundo comando del ejemplo determina si el usuario de prueba puede iniciar sesión en Lync Server y después realizar una llamada al número telefónico de destino (+15551234567). Para llevar a cabo esta tarea, se llama a Test-CsPstnOutboundCall junto con los siguientes parámetros: TargetFqdn (el nombre de dominio completo del grupo de registrador); UserSipAddress (la dirección SIP del usuario que realiza la llamada); UserCredential (el objeto de Windows PowerShell que contiene las credenciales del usuario de prueba) y TargetPstnPhoneNumber (el número de teléfono al que se llama).
-------------------------- Ejemplo 3 --------------------------
Test-CsPstnOutboundCall -TargetFqdn atl-cs-001.litwareinc.com -UserSipAddress sip:kenmyer@litwareinc.com -TargetPstnPhoneNumber "+15551234567"
En el ejemplo 3 se muestra cómo se puede usar Test-CsPstnOutboundCall en modo de plataforma de servidor. En este modo se especifica la dirección SIP del usuario, pero no se incluyen credenciales de usuario. Cuando se ejecutan de esta manera, Lync Server 2010 usa certificados para probar el usuario.