Compartir a través de

  • Artículo

New-CsHealthMonitoringConfiguration

 

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

Crea una nueva recopilación de opciones de configuración de seguimiento de estado para usar en su organización. 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

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

New-CsHealthMonitoringConfiguration -FirstTestUserSipUri <String> -SecondTestUserSipUri <String> -TargetFqdn <String> [-Confirm [<SwitchParameter>]] [-FirstTestSamAccountName <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-SecondTestSamAccountName <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 realizar de dos maneras diferentes. Muchos administradores usarán los cmdlets CsHealthMonitoringConfiguration para configurar cuentas de prueba para cada grupo de registrador. Las cuentas de prueba son un par de cuentas de usuario que se han preconfigurado para usarse con transacciones sintéticas. (Normalmente se usan cuentas de prueba, no cuentas de usuarios reales.) Cuando se configuran estas cuentas de prueba para un grupo, los administradores pueden ejecutar una transacción sintética según ese grupo sin tener que especificar las identidades (ni suministrar las credenciales) para las cuentas de usuario involucradas en la prueba. 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). Tenga en cuenta que para llevar a cabo una transacción sintética usando cuentas de usuario reales deberá especificar las credenciales de cada usuario.

El cmdlet New-CsHealthMonitoringConfiguration proporciona una manera de crear las opciones de configuración de un nuevo registrador de seguimiento de estado para un grupo de registrador o de director. Cuando se crea una nueva recopilación de opciones de configuración de seguimiento, debe especificar el nombre de dominio completo (FQDN) del grupo, además de las direcciones SIP de las dos cuentas que servirán como cuentas de prueba del grupo. (Sin embargo, no necesita proporcionar las contraseñas de esas cuentas de prueba). Recuerde que cada grupo puede hospedar, como máximo, una única recopilación de opciones de configuración de seguimiento de estado. Si intenta crear una nueva recopilación para el grupo atl-cs-001.litwareinc.com y ese grupo ya ha sido asignado a un registrador, se producirá un error en ese comando.

Al ejecutar New-CsHealthMonitoringConfiguration probablemente reciba una advertencia si existen grupos a los que no se han asignado usuarios de prueba; esto puede incluir grupos de director y grupos de Office Communications Server. Es posible ignorar las advertencias. Si lo prefiere, puede asignar usuarios de prueba de otros grupos a los grupos de director; eso podría permitirle ejecutar el cmdlet Test-CsRegistration para el Director. Sin embargo, no se puede asignar usuarios de prueba a los grupos de Office Communications Server.

Quiénes pueden ejecutar este cmdlet: De forma predeterminada, los miembros de los grupos siguientes están autorizados a ejecutar el cmdlet New-CsHealthMonitoringConfiguration de 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 "New-CsHealthMonitoringConfiguration"}

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Opcional

FQDN

FQDN del grupo donde se asignarán las opciones de configuración de seguimiento de estado (por ejemplo: -Identity atl-cs-001.litwareinc.com). Se producirá un error en el comando si el grupo especificado ya aloja una recopilación de opciones de configuración de seguimiento de estado.

El parámetro Identity es equivalente al parámetro TargetFqdn. Puede usar cualquier parámetro al crear una nueva recopilación de configuraciones. Si abandona ambos parámetros, New-CsHealthMonitoringConfiguration le solicitará que escriba la identidad.

TargetFqdn

Opcional

FQDN

FQDN del grupo donde se asignarán las opciones de configuración de seguimiento de estado (por ejemplo: -TargetFqdn atl-cs-001.litwareinc.com). Se producirá un error en el comando si el grupo especificado ya aloja una recopilación de opciones de configuración de seguimiento de estado.

El parámetro TargetFqdn es equivalente al parámetro Identity. Puede usar cualquier parámetro al crear una nueva recopilación de configuraciones. Si abandona ambos parámetros, New-CsHealthMonitoringConfiguration le solicitará que escriba la identidad.

FirstTestSamAccountName

Opcional

Cadena de caracteres

SamAccountName del primer usuario de prueba. Se debe especificar el FirstTestSamAccountName con el formato dominio\nombre de usuario; por ejemplo:

-FirstTestSamAccountName litwareinc\kenmyer

FirstTestUserSipUri

Opcional

Dirección SIP

Dirección SIP del primer usuario de prueba que se configurará para usar con esta recopilación de configuraciones de seguimiento de estado. Recuerde que la dirección SIP debe incluir el prefijo sip. Por ejemplo: -FirstTestUserSipUri "sip:kenmyer@litwareinc.com".

SecondTestSamAccountName

Opcional

Cadena de caracteres

SamAccountName del segundo usuario de prueba. Se debe especificar el SecondTestSamAccountName con el formato dominio\nombre de usuario; por ejemplo:

-SecondTestSamAccountName litwareinc\pilar

SecondTestUserSipUri

Opcional

Dirección SIP

Dirección SIP del segundo usuario de prueba que se configurará para usar con esta recopilación de configuraciones de seguimiento de estado. Recuerde que la dirección SIP debe incluir el prefijo sip. Por ejemplo: -SecondTestUserSipUri "sip:pilar@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.

InMemory

Opcional

Parámetro modificador

Crea una referencia de objeto sin confirmar realmente el objeto como cambio permanente. Si se asigna la salida de este cmdlet llamado con este parámetro en una variable, puede realizar cambios en las propiedades de la referencia del objeto y después confirmar estos cambios, llamando a este conjunto coincidente de cmdlet, - cmdlet.

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

Ninguno. New-CsHealthMonitoringConfiguration no acepta entradas canalizadas.

Tipos de valores devueltos

New-CsHealthMonitoringConfiguration crea nuevas instancias del objeto Microsoft.Rtc.Management.WritableConfig.Settings.HealthMonitoring.HealthMonitoringSettings.

Ejemplo

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

New-CsHealthMonitoringConfiguration -Identity atl-cs-001.litwareinc.com -FirstTestUserSipUri "sip:kenmyer@litwareinc.com" -SecondTestUserSipUri "sip:pilar@litwareinc.com"

El comando que se muestra en el Ejemplo 1 crea una nueva recopilación de opciones de configuración de seguimiento de estado para el grupo atl-cs-001.litwareinc.com. Estas nuevas configuraciones usarán sip:kenmyer@litwareinc.com y sip:pilar@litwareinc.com como las dos cuentas de prueba preconfiguradas.

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

$x = Get-CsService -Registrar | Select-Object PoolFqdn
foreach ($i in $x)
   {New-CsHealthMonitoringConfiguration -Identity $i.PoolFqdn -FirstTestUserSipUri "sip:kenmyer@litwareinc.com" -SecondTestUserSipUri "sip:pilar@litwareinc.com"}

En el Ejemplo 2 se crea una nueva recopilación de opciones de configuración de seguimiento de estado para todos los grupos de registrador de la organización. Para ello, el primer comando del ejemplo usa el cmdlet Get-Service y el parámetro Registrar para devolver una recopilación de todos los grupos de registrador. A continuación, esta recopilación se canaliza al cmdlet Select-Object, que elige solo la propiedad PoolFqdn. (Esta propiedad devuelve el FQDN de un grupo de registrador.) Estos FQDN se almacenan en una variable denominada $x.

En el segundo comando, cada bucle creado se repite en cada FQDN de un grupo de registrador. En cada FQDN, se llama a New-CsHealthMonitoringConfiguration para crear una nueva recopilación de opciones de configuración, con el FQDN almacenado en $x que se usa como identidad de la nueva recopilación. A cada recopilación se le asignan las mismas dos cuentas: sip:kenmyer@litwareinc.com y sip:pilar@litwareinc.com.