Test-CsPstnPeerToPeerCall
Última modificación del tema: 2012-03-25
Prueba la capacidad de un par de usuarios para realizar una llamada punto a punto mediante la puerta de enlace de la red telefónica conmutada (RTC).
Sintaxis
Test-CsPstnPeerToPeerCall -TargetFqdn <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-ReceiverSipAddress <String>] [-RegistrarPort <Nullable>] [-SenderSipAddress <String>]
Test-CsPstnPeerToPeerCall [-TargetFqdn <String>] -ReceiverCredential <PSCredential> -ReceiverSipAddress <String> -SenderCredential <PSCredential> -SenderSipAddress <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>]
Descripción detallada
Test-CsPstnPeerToPeerCall 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).
Las transacciones sintéticas se suelen llevar a cabo de dos formas. 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 preconfigurados para usar transacciones sintéticas. (Normalmente se usan cuentas de prueba, no cuentas de usuarios reales.) Con los usuarios de prueba configurados para un grupo de servidores, 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.
Por otra parte, los administradores pueden optar por ejecutar una transacción sintética con cuentas de usuario reales. Por ejemplo, si dos usuarios no pueden intercambiar mensajes instantáneos, 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) 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.
También se puede utilizar Test-CsPstnPeerToPeerCall en modo plataforma de servicio. En ese caso, solo será necesario especificar la dirección SIP de los usuarios y Lync Server 2010 utilizará los certificados para autenticar a esos usuarios.
Al llamar a Test-CsPstnPeerToPeerCall, el cmdlet intentará primero iniciar sesión con los dos usuarios de prueba en Lync Server. Si asumimos que las sesiones se inician correctamente, el cmdlet hará que el usuario 1 intente llamar al usuario 2 mediante la puerta de enlace de RTC; Test-CsPstnPeerToPeerCall realizará la llamada con el plan de marcado, la directiva de voz y otras opciones de configuración y directivas asignadas al usuario de prueba. Si la prueba da el resultado esperado, el cmdlet verificará que el usuario 2 pudo responder la llamada y cerrará la sesión de ambas cuentas en el sistema.
Test-CsPstnPeerToPeerCall realiza una llamada telefónica real para verificar que la conexión se puede establecer y, además, transmitir códigos de tono de marcado de frecuencia múltiple (DTMF) por toda la red para determinar si se pueden enviar contenidos multimedia a través de la conexión. Sin embargo, el mismo cmdlet responde la llamada y no se requiere terminación manual. (Es decir, no es necesario que nadie responda y cuelgue el teléfono al que se llama.)
Quién puede ejecutar este cmdlet: Para devolver una lista de todos los roles de control de acceso basado en roles (RBAC) a los que se ha asignado este cmdlet (incluido cualquier otro rol RBAC personalizado que usted mismo haya creado), ejecute el siguiente comando desde Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Test-CsPstnPeerToPeerCall"}
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 PSCredential |
El objeto de credenciales de usuario correspondiente a la primera de las dos cuentas de usuario que se pondrán a prueba. El valor transferido a ReceiverCredential debe 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" Debe facilitar la contraseña de usuario al ejecutar este comando. Las credenciales del receptor no son necesarias si se está ejecutando la prueba con las opciones de configuración de supervisión de mantenimiento del grupo o si se está ejecutando en modo de plataforma de servidor. |
ReceiverSipAddress |
Opcional |
Dirección SIP |
Dirección SIP de la primera de las dos cuentas de usuario que se pondrán a prueba. Por ejemplo: -ReceiverSipAddress "sip:pilar@litwareinc.com". El parámetro ReceiverSIPAddress debe referirse a la misma cuenta de usuario que ReceiverCredential. La dirección SIP no es obligatoria si se ejecuta la prueba con las opciones de configuración de supervisión de mantenimiento del grupo. |
RegistrarPort |
Opcional |
Entero |
Puerto SIP usado por el servicio registrador. Este parámetro no es obligatorio si el registrador usa el puerto predeterminado 5061. |
SenderCredential |
Opcional |
Objeto PSCredential |
El objeto de credenciales de usuario correspondiente a la segunda de las dos cuentas de usuario que se pondrán a prueba. El valor transferido a SenderCredential debe ser una referencia a objeto obtenida mediante el cmdlet Get-Credential. Por ejemplo, este código devuelve un objeto de credenciales del usuario litwareinc\kenmyer y almacena dicho objeto en una variable llamada $x: $x = Get-Credential "litwareinc\kenmyer" Debe facilitar la contraseña de usuario al ejecutar este comando. Las credenciales del remitente no son necesarias si se está ejecutando la prueba con las opciones de configuración de supervisión de mantenimiento del grupo o si se está ejecutando en modo de plataforma de servidor. |
SenderSipAddress |
Opcional |
Dirección SIP |
Dirección SIP de la segunda de las dos cuentas de usuario que se pondrán 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 se ejecuta la prueba con las opciones de configuración de supervisión de mantenimiento 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 ocurrir al ejecutar el comando. |
Verbose |
Opcional |
Parámetro modificador |
Notifica los detalles de la actividad en la pantalla mientras se ejecuta el cmdlet. |
Tipos de entrada
Ninguno. Test-CsPstnPeerToPeerCall no acepta los datos transferidos.
Tipos de valores devueltos
Test-CsPstnPeerToPeerCall devuelve una instancia del objeto Microsoft.Rtc.SyntheticTransactions.TaskOutput.
Ejemplo
-------------------------- Ejemplo 1 --------------------------
Test-CsPstnPeerToPeerCall -TargetFqdn atl-cs-001.litwareinc.com
En el ejemplo anterior se comprueba si un par de usuarios de prueba preconfigurados puede iniciar sesión en el grupo atl-cs-001.litwareinc.com; una vez hayan iniciado sesión, Test-CsPstnPeerToPeerCall comprueba si ambos usuarios pueden realizar una llamada punto a punto mediante la puerta de enlace de RTC. 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 el sistema y, a continuación, si este usuario puede llamar al segundo usuario definido del grupo.
Si no se ha definido ningún usuario de prueba, el comando producirá un error porque no sabrá qué usuarios emplear para realizar la prueba. Si no ha definido usuarios de prueba para un grupo de servidores y no está trabajando en modo de plataforma de servidores, deberá incluir los parámetros SenderSipAddress y ReceiverSipAddress y las credenciales correspondientes para los usuarios que se utilizarán como cuentas de prueba. Después, Test-CsPstnPeerToPeerCall llevará a cabo sus comprobaciones utilizando los dos usuarios especificados.
-------------------------- Ejemplo 2 --------------------------
$cred1 = Get-Credential "litwareinc\pilar"
$cred2 = Get-Credential "litwareinc\kenmyer"
Test-CsPstnPeerToPeerCall -TargetFqdn atl-cs-001.litwareinc.com -SenderSipAddress "sip:jhaas@litwareinc.com" -SenderCredential $cred1 -ReceiverSipAddress "sip:kenmyer@litwareinc.com" -ReceiverCredential $cred2
Los comandos del Ejemplo 2 comprueban la capacidad de un par de usuarios (litwareinc\pilar y litwareinc\kenmyer) para iniciar sesión en Lync Server y, a continuación, realizan una llamada punto a punto mediante la puerta de enlace de 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 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). El objeto de credenciales resultante se almacena a continuación en una variable llamada $cred1. El segundo comando realiza la misma acción pero, esta vez, devuelve un objeto de credenciales de la cuenta de Ken Myer.
Con los dos objetos de credenciales, el tercer comando del ejemplo averigua si los dos usuarios pueden iniciar sesión en Lync Server y, a continuación, realiza una llamada punto a punto mediante la puerta de enlace de RTC. Para llevar a cabo esta tarea, se llama a Test-CsPstnPeerToPeerCall junto con los siguientes parámetros: TargetFqdn (el FQDN del grupo de registrador); SenderSipAddress (la dirección SIP del primer usuario de prueba); SenderCredential (el objeto Windows PowerShell que contiene las credenciales de este mismo usuario); ReceiverSipAddress (la dirección SIP del otro usuario de prueba) y ReceiverCredential (el objeto Windows PowerShell que contiene las credenciales del otro usuario).
-------------------------- Ejemplo 3 --------------------------
Test-CsPstnPeerToPeerCall -TargetFqdn atl-cs-001.litwareinc.com -SenderSipAddress "sip:jhaas@litwareinc.com" -ReceiverSipAddress "sip:kenmyer@litwareinc.com"
El Ejemplo 3 muestra la utilización de Test-CsPstnPeerToPeerCall en modo de plataforma de servidor. En este modo, se especifican las direcciones SIP de los usuarios de prueba, pero no se incluyen las credenciales de usuario. Cuando se ejecuta así, Lync Server 2010 utiliza certificados para autenticar a los dos usuarios de prueba.