Test-CsP2PAV
Última modificación del tema: 2012-03-26
Comprueba la capacidad de dos usuarios para realizar una llamada de audio y vídeo (A/V) de par a par.
Sintaxis
Test-CsP2PAV -TargetFqdn <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-ReceiverSipAddress <String>] [-RegistrarPort <Nullable>] [-SenderSipAddress <String>]
Test-CsP2PAV [-TargetFqdn <String>] -ReceiverCredential <PSCredential> -ReceiverSipAddress <String> -SenderCredential <PSCredential> -SenderSipAddress <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>]
Descripción detallada
Test-CsP2PAV 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 sencillamente 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.
Test-CsP2PAV se usa para determinar si dos usuarios de prueba pueden participar en una conversación de audio y vídeo (A/V) de par a par. Para probar este escenario, el cmdlet se inicia registrando los dos usuarios en Lync Server. Suponiendo que los dos inicien sesión correctamente, el primer usuario invitará al segundo a unirse a una llamada de A/V. El segundo usuario acepta la llamada y se prueba la conexión entre ambos. A continuación, la llamada finaliza y los usuarios cierran sesión en el sistema.
En realidad, Test-CsP2PAV no realiza una llamada de A/V, la información multimedia no se intercambia entre los usuarios de prueba. En su lugar, el cmdlet tan solo verifica que se realizan las conexiones adecuadas y que los dos usuarios pueden mantener este tipo de llamada.
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-CsP2PAV"}
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 usando 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. La credencial del receptor no es obligatoria si ejecuta la prueba con las opciones de configuración de supervisión de mantenimiento del grupo. |
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 usando 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. La credencial del remitente no es obligatoria si ejecuta la prueba con las opciones de configuración de supervisión de mantenimiento del grupo. |
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: -SenderSipAddres "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. |
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. |
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. |
Verbose |
Opcional |
Parámetro modificador |
Notifica los detalles de la actividad en la pantalla mientras se ejecuta el cmdlet. |
Tipos de entrada
Ninguno. Test-CsP2PAV no acepta la entrada transferida.
Tipos de valores devueltos
Test-CsP2PAV devuelve una instancia del objeto Microsoft.Rtc.SyntheticTransactions.TaskOutput.
Ejemplo
-------------------------- Ejemplo 1 --------------------------
Test-CsP2PAV -TargetFqdn atl-cs-001.litwareinc.com
En el ejemplo anterior se comprueba que un par de usuarios de prueba preconfigurados pueden iniciar sesión en el grupo atl-cs-001.litwareinc.com y realizar una llamada de audio y vídeo de par a par. Este comando solo funcionará si se han definido usuarios de prueba para el grupo de servidores atl-cs-001.litwareinc.com. En caso afirmativo, el comando determinará si los dos usuarios pueden iniciar sesión en el sistema y, en caso de que así sea, si pueden conversar usando una llamada de audio y vídeo.
Si no se han definido usuarios de prueba, el comando producirá un error porque no sabrá qué usuarios emplear para realizar la prueba. Si no ha definido ningún usuario de prueba para el grupo, deberá incluir los parámetros SenderSipAddress y ReceiverSipAddress, además de las credenciales correspondientes a los usuarios implicados en el intercambio de mensajería instantánea. Test-CsP2PAV llevará a cabo sus comprobaciones a continuación utilizando los dos usuarios especificados.
-------------------------- Ejemplo 2 --------------------------
$cred1 = Get-Credential "litwareinc\pilar"
$cred2 = Get-Credential "litwareinc\kenmyer"
Test-CsP2PAV -TargetFqdn atl-cs-001.litwareinc.com -SenderSipAddress "sip:pilar@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 de A/V. 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 a mano, el tercer comando del ejemplo determina si los dos usuarios pueden iniciar sesión en Lync Server y realizar una llamada de audio y vídeo de par a par. Para llevar a cabo esta tarea, se llama a Test-CsP2PAV y a los parámetros siguientes: 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).