Compartir a través de


Remove-CsHealthMonitoringConfiguration

 

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

Quita una recopilación existente de configuraciones de supervisión de mantenimiento. Estas configuraciones permiten a los administradores ejecutar pruebas de control de calidad sin tener que proporcionar contraseñas y nombres de usuarios de las cuentas de prueba requeridas.

Sintaxis

Remove-CsHealthMonitoringConfiguration -Identity <XdsGlobalRelativeIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-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 realizar de dos maneras diferentes. Muchos administradores usarán los cmdlets CsHealthMonitoringConfiguration para configurar cuentas de prueba para cada grupo de registrador. Estas cuentas 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 estas cuentas de prueba configuradas 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. En cambio, la transacción sintética usará automáticamente las cuentas de prueba preconfiguradas al realizar las comprobaciones.

De forma alternativa, los administradores pueden ejecutar una transacción sintética con cuentas de usuarios reales. Por ejemplo, si dos usuarios no pueden intercambiar mensajes instantáneos, el administrador puede ejecutar una transacción sintética con las dos cuentas del usuario en cuestión (en lugar de un par de cuentas de prueba). Si decide llevar a cabo una transacción sintética con cuentas de usuario reales, deberá especificar las credenciales de cada usuario.

El cmdlet Remove-CsHealthMonitoringConfiguration proporciona un medio para eliminar cualquiera de las opciones de configuración de seguimiento de estado que se han configurado en su organización.

Quiénes pueden ejecutar este cmdlet: De manera predeterminada, los miembros de los siguientes grupos están autorizados para ejecutar el cmdlet Remove-CsHealthMonitoringConfiguration en forma local: RTCUniversalServerAdmins. 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 "Remove-CsHealthMonitoringConfiguration"}

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Requerido

Identidad Xds

Nombre de dominio completo (FQDN) del grupo que hospeda las configuraciones de seguimiento de estado que deben eliminarse. Por ejemplo: -Identity atl-cs-001.litwareinc.com.

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.

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. Remove-CsHealthMonitoringConfiguration acepta instancias canalizadas del objeto de configuración del seguimiento de estado.

Tipos de valores devueltos

Ninguno. En cambio, Remove-CsHealthMonitoringConfiguration elimina las instancias existentes del objeto Microsoft.Rtc.Management.WritableConfig.Settings.HealthMonitoring.HealthMonitoringSettings.

Ejemplo

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

Remove-CsHealthMonitoringConfiguration -Identity atl-cs-001.litwareinc.com

El comando que se muestra en el Ejemplo 1 elimina la recopilación de configuraciones de supervisión de mantenimiento con el valor Identity atl-cs-001.litwareinc.com. Debido a que las identidades deben ser únicas, este comando eliminará, como máximo, una sola recopilación de configuraciones.

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

Get-CsHealthMonitoringConfiguration | Remove-CsHealthMonitoringConfiguration 

El Ejemplo 2 elimina todas las configuraciones de supervisión de mantenimiento actualmente en uso. Para ello, el comando llama primero a Get-CsHealthMonitoringConfiguration sin ningún parámetro; esto devuelve una recopilación de todas las configuraciones de seguimiento de estado en su organización. A continuación, esta recopilación se canaliza a Remove-CsHealthMonitoringConfiguration, que elimina cada elemento en la recopilación.

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

Get-CsHealthMonitoringConfiguration -Filter *.litwareinc.com  | Remove-CsHealthMonitoringConfiguration 

En el comando anterior se devuelven todas las opciones de configuración de seguimiento de estado que se han creado para el dominio litwareinc.com. Para hacerlo, se llama aGet-CsHealthMonitoringConfiguration junto con el parámetro Filter; el valor de filtro "*.litwareinc.com" garantiza que se devolverán solo las configuraciones cuya Identidad termine con el valor de cadena ".litwareinc.com". A continuación, la recopilación filtrada se canaliza a Remove-CsHealthMonitoringConfiguration, que elimina cada uno de los elementos de la recopilación.

-------------------------- Ejemplo 4 --------------------------

(Get-CsHealthMonitoringConfiguration | Where-Object {$_.FirstTestUserSipUri -eq "sip:kenmyer@litwareinc.com" -or $_.SecondTestUserSipUri -eq " sip:kenmyer@litwareinc.com"}) | Remove-CsHealthMonitoringConfiguration

El comando que se muestra en el Ejemplo 4 elimina todas las configuraciones de supervisión de mantenimiento que incluyen al usuario con la dirección SIP sip:kenmyer@litwareinc.com como uno de los usuarios de prueba. A fin de realizar esta tarea, el comando primero comienza con la llamada a Get-CsHealthMonitoringConfiguration sin parámetros adicionales; esto devuelve una recopilación de todas las opciones de configuración de seguimiento de estado actualmente en uso en la organización. A continuación, esta recopilación se canaliza al cmdlet Where-Object, que extrae sólo las configuraciones cuya propiedad FirstTestUserSipUri es igual a (-eq) "sip:kenmyer@litwareinc.com" o cuya propiedad SecondTestUserSipUri es igual a "sip:kenmyer@litwareinc.com". A su vez, esas configuraciones se canalizan a Remove-CsHealthMonitoringConfiguration Remove-CsHealthMonitoringConfiguration y son eliminadas por éste.