Test-CsAVConference
Última modificación del tema: 2012-03-26
Comprueba la capacidad de un par de usuarios para participar en una conferencia de audio o vídeo (A/V).
Sintaxis
Test-CsAVConference -TargetFqdn <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-ReceiverSipAddress <String>] [-RegistrarPort <Nullable>] [-SenderSipAddress <String>]
Test-CsAVConference [-TargetFqdn <String>] -ReceiverCredential <PSCredential> -ReceiverSipAddress <String> -SenderCredential <PSCredential> -SenderSipAddress <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>]
Descripción detallada
Test-CsAVConference es un ejemplo de "transacción sintética". Las transacciones sintéticas se usan en Microsoft 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.
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 esas dos cuentas de usuario (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.
El cmdlet Test-CsAVConference comprueba si dos usuarios de prueba pueden mantener una conferencia de A/V. Cuando se ejecuta el cmdlet, los dos usuarios ya deben haber iniciado sesión en el sistema. Con la sesión correctamente iniciada, el primer usuario crea una conferencia de A/V y, entonces, espera a que el segundo usuario se una a esa misma conferencia. Después de un breve intercambio de datos, la conferencia se elimina y los dos usuarios de prueba finalizan la sesión.
Test-CsAVConference no realiza realmente una conferencia de A/V entre dos usuarios de prueba. En cambio, el cmdlet simplemente comprueba que los dos usuarios puedan realizar las conexiones necesarias para llevar a cabo la conferencia de A/V.
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-CsAVConference"}
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 hacer referencia 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: -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.
Tipos de valores devueltos
Test-CsAVConference devuelve una instancia del objeto Microsoft.Rtc.SyntheticTransactions.TaskOutput.
Ejemplo
-------------------------- Ejemplo 1 --------------------------
Test-CsAVConference -TargetFqdn atl-cs-001.litwareinc.com
En el ejemplo anterior se comprueba si un par de usuarios de prueba preconfigurados pueden iniciar sesión en el grupo de servidores atl-cs-001.litwareinc.com y luego participar en una conferencia de A/V. Este comando solo funcionará si se han definido usuarios de prueba para el grupo de servidores atl-cs-001.litwareinc.com. Si es así, el comando determinará si los dos usuarios pueden iniciar sesión en el sistema. En caso afirmativo, el primer usuario de prueba creará una conferencia de A/V e invitará al segundo a participar; a continuación, el cmdlet comprobará si los dos usuarios han podido establecer conexión correctamente o no.
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 mensajes instantáneos. A continuación, Test-CsAVConference realizará las comprobaciones mediante los dos usuarios especificados.
-------------------------- Ejemplo 2 --------------------------
$cred1 = Get-Credential "litwareinc\pilar"
$cred2 = Get-Credential "litwareinc\kenmyer"
Test-CsAVConference -TargetFqdn atl-cs-001.litwareinc.com -SenderSipAddress "sip:pilar@litwareinc.com" -SenderCredential $cred1 -ReceiverSipAddress "sip:kenmyer@litwareinc.com" -ReceiverCredential $cred2
Los comandos que se muestran en el Ejemplo 2 prueban la capacidad de un par de usuarios (litwareinc\pilar y litwareinc\kenmyer) de iniciar sesión en Lync Server 2010 y participar en una conferencia 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 ambos objetos credencial en mano, el tercer comando del ejemplo determina si los dos usuarios pueden iniciar sesión en Lync Server 2010y participar en una conferencia de A/V. Para realizar esta tarea, se activa Test-CsAVConference 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).