Compartir a través de

  • Artículo

Set-CsHealthMonitoringConfiguration

 

Última modificación del tema: 2012-03-25

Modifica una colección existente de opciones de configuración de seguimiento de estado. Esta configuración permite a los administradores ejecutar pruebas de control de calidad sin tener que facilitar los nombres de usuario y las contraseñas de las cuentas de prueba necesarias.

Sintaxis

Set-CsHealthMonitoringConfiguration [-Identity <XdsGlobalRelativeIdentity>] [-Confirm [<SwitchParameter>]] [-FirstTestSamAccountName <String>] [-FirstTestUserSipUri <String>] [-Force <SwitchParameter>] [-SecondTestSamAccountName <String>] [-SecondTestUserSipUri <String>] [-WhatIf [<SwitchParameter>]]

Set-CsHealthMonitoringConfiguration [-Confirm [<SwitchParameter>]] [-FirstTestSamAccountName <String>] [-FirstTestUserSipUri <String>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-SecondTestSamAccountName <String>] [-SecondTestUserSipUri <String>] [-WhatIf [<SwitchParameter>]]

Descripción detallada

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 pueden llevar a cabo de dos formas. Muchos administradores usarán los cmdlets CsHealthMonitoringConfiguration para configurar cuentas de prueba para cada grupo de registrador. Estas cuentas de prueba consisten en un par de usuarios que se han preconfigurado para su uso con transacciones sintéticas. (Normalmente se usan cuentas de prueba, no cuentas de usuarios reales.) Cuando se han configurado cuentas de prueba para un grupo, los administradores pueden ejecutar una transacción sintética en dicho grupo sin tener que especificar las identidades de las cuentas de usuario implicadas en la prueba, ni facilitar sus credenciales. Por el contrario, la transacción sintética usará automáticamente las cuentas de prueba preconfiguradas al realizar sus comprobaciones.

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). Si decide llevar a cabo una transacción sintética usando cuentas de usuario reales, deberá especificar las credenciales de cada usuario.

Una vez que haya configurado las opciones de un seguimiento de estado, puede modificarlas en cualquier momento con el cmdlet Set-CsHealthMonitoringConfiguration. Este cmdlet proporciona una forma de cambiar cualquiera de las cuentas de prueba (o ambas) configuradas para usarlas con un grupo.

Quién puede ejecutar este cmdlet: de forma predeterminada, los miembros de los siguientes grupos tienen autorización para ejecutar el cmdlet Set-CsHealthMonitoringConfiguration localmente: RTCUniversalServerAdmins. Para obtener una lista de todos los roles de control de acceso basado en rol (RBAC), este rol se ha asignado (así como cualquier otro rol RBAC personalizado que haya creado) para ejecutar el siguiente comando desde el símbolo del sistema Windows PowerShell:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsHealthMonitoringConfiguration"}

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Requerido

FQDN

Nombre de dominio completo (FQDN) del grupo de servidores en el que se han asignado las opciones de configuración de seguimiento de estado que se van a modificar. Por ejemplo: -Identity atl-cs-001.litwareinc.com.

Instance

Opcional

Objeto HealthMonitoringSettings

Permite enviar una referencia a un objeto al cmdlet, en lugar de definir valores de parámetros individuales.

FirstTestSamAccountName

Opcional

Cadena de caracteres

SamAccountName del primer usuario de prueba. El parámetro FirstTestSamAccountName debe especificarse con el formato dominio\nombreDeUsuario. Por ejemplo:

-FirstTestSamAccountName litwareinc\kenmyer

FirstTestUserSipUri

Opcional

Dirección SIP

Dirección SIP del primer usuario de pruebas que se va a configurar para que use esta colección de configuraciones de seguimiento de estado. Tenga en cuenta que la dirección SIP debe incluir el sip: . Por ejemplo: -FirstTestUserSipUri "sip:kenmyer@litwareinc.com".

SecondTestSamAccountName

Opcional

Cadena de caracteres

SamAccountName del segundo usuario de prueba. El parámetro SecondTestSamAccountName debe especificarse con el formato dominio\nombreDeUsuario. Por ejemplo:

-SecondTestSamAccountName litwareinc\pilar

SecondTestUserSipUri

Opcional

Dirección SIP

Dirección SIP del segundo usuario de pruebas para configurar para su uso mediante esta colección de configuraciones de seguimiento de estado. Tenga en cuenta que la dirección SIP debe incluir el sip: . Por ejemplo: -FirstTestUserSipUri "sip:pilar@litwareinc.com".

Force

Opcional

Parámetro modificador

Suprime la visualización de los mensajes de error que no son graves y que pueden surgir al ejecutar el comando.

WhatIf

Opcional

Parámetro modificador

Describe lo que ocurriría si se ejecutara el comando sin ejecutarlo realmente.

Confirm

Opcional

Parámetro modificador

Solicita confirmación antes de ejecutar el comando.

Tipos de entrada

Objeto Microsoft.Rtc.Management.WritableConfig.Settings.HealthMonitoring.HealthMonitoringSettings. Set-CsHealthMonitoringConfiguration acepta instancias transferidas del objeto de configuración de seguimiento de estado.

Tipos de valores devueltos

Ninguno. En su lugar, Set-CsHealthMonitoringConfiguration modifica instancias del objeto Microsoft.Rtc.Management.WritableConfig.Settings.HealthMonitoring.HealthMonitoringSettings.

Ejemplo

-------------------------- Ejemplo 1 ------------------------

Set-CsHealthMonitoringConfiguration -Identity atl-cs-001.litwareinc.com -FirstTestUserSipUri "sip:kenmyer@litwareinc.com" -FirstTestSamAccountName "litwareinc\kenmyer"

El comando que aparece en el ejemplo 1 configura el primer usuario de prueba asignado a las opciones de configuración de seguimiento de estado para el grupo de servidores atl-cs-001.litwareinc.com. En este ejemplo, la dirección SIP del nuevo usuario de prueba se establece en sip:kenmyer@litwareinc.com y el SamAccountName para este usuario de prueba, en kenmyer.

-------------------------- Ejemplo 2 ------------------------

Get-CsHealthMonitoringConfiguration | Set-CsHealthMonitoringConfiguration -FirstTestUserSipUri "sip:kenmyer@litwareinc.com" -FirstTestSamAccountName "litwareinc\kenmyer"

El comando anterior es una variación del comando que aparece en el ejemplo 1. Sin embargo, en este caso, el mismo usuario de prueba nuevo se asigna a cada colección de las opciones de configuración de seguimiento de estado en uso en la organización. Para ello, en primer lugar el comando usa Get-CsHealthMonitoringConfiguration para devolver una colección de todas las opciones de configuración de seguimiento de estado. A continuación, esta colección se transfiere a Set-CsHealthMonitoringConfiguration, que asigna la misma dirección SIP y SamAccountName del primer usuario de prueba a cada elemento de la colección.

-------------------------- Ejemplo 3 ------------------------

Get-CsHealthMonitoringConfiguration | Where-Object {$_.FirstTestUserSipUri -eq "sip:pilar@litwareinc.com"} | Set-CsHealthMonitoringConfiguration -FirstTestUserSipUri "sip:kenmyer@litwareinc.com" -FirstTestSamAccountName "litwareinc\kenmyer"

En el ejemplo 3 se muestra cómo puede realizar una búsqueda y sustitución del primer usuario de prueba asignado a una colección de opciones de configuración de estado; en este ejemplo, el usuario con la dirección SIP sip:pilar@litwareinc.com se sustituye cada vez que aparece como el primer usuario de prueba de una colección.

Para ello, en primer lugar, el comando llama a Get-CsHealthMonitoringConfiguration sin ningún parámetro adicional; esto devuelve una colección de todas las opciones de configuración de seguimiento de estado en uso en ese momento en la organización. A continuación, esta colección se transfiere al cmdlet Where-Object, que selecciona únicamente aquellos elementos en los que la propiedad FirstTestUserSipUri es igual a (-eq) sip:pilar@litwareinc.com. Esta colección filtrada se transfiere, a su vez, a Set-CsHealthMonitoringConfiguration, que toma cada elemento de la colección y establece el valor de la propiedad FirstTestUserSipUri en sip:kenmyer@litwareinc.com y el valor de la propiedad FirstTestSamAccountName, en kenmyer.